library_builder.php

<?php


function libraries_builder($p)
{
    install_openssl($p);
    install_libiconv($p);//没有 libiconv.pc 文件 不能使用 pkg-config 命令
    install_ncurses($p);
    install_readline($p);//依赖 ncurses

    install_liblzma($p);
    install_libxml2($p); //依赖 libiconv  liblzma
    install_libxslt($p); //依赖 libxml2 libiconv

    install_brotli($p); //有多种安装方式，选择使用cmake 安装
    install_cares($p);  // swoole 使用 SWOOLE_CFLAGS 实现
    install_gmp($p);    // GNU高精度算术运算库


    install_libyaml($p);
    install_libsodium($p);

    install_bzip2($p);//没有 libbz2.pc 文件，不能使用 pkg-config 命令
    // 使用时类似： BZIP2_LIBS=-L/usr/bizp2/lib -lbz2  BZIP2_CFLAGS="-I/usr/bizp2/include"
    install_zlib($p);
    install_liblz4($p); //有多种安装方式，选择cmake方式安装
    install_libzstd($p); //zstd 依赖 lz4
    install_libzip($p); //zip 依赖 openssl zlib bzip2  liblzma zstd

    install_sqlite3($p);
    install_icu($p);
    //依赖 linux : -lstdc++ ; macOS:  libc++ //注意事项：https://www.zhihu.com/question/343205052
    //CLDR 是 i18n 的一套核心规范( Common Locale Data Respository ) 即 通用的本地化数据存储库
    //https://cldr.unicode.org/

    // php composer 依赖的扩展 ： https://github.com/composer/composer/blob/c23beac9c508b701bb481d1c5269e7a2a79e0b60/src/Composer/Repository/PlatformRepository.php#L203

    install_oniguruma($p);
    //install_mimalloc($p);

    install_libjpeg($p);
    install_libgif($p);//没有 libgif.pc 文件，不能使用 pkg-config 命令
    install_libpng($p); //依赖 zlib

    install_libwebp($p); //依赖 libgif libpng libjpeg
    install_freetype($p); //依赖 zlib bzip2 libpng  brotli  HarfBuzz  (HarfBuzz暂不启用，启用需要安装ninja meson python3 pip3 进行构建)

    install_imagemagick($p);
    //依赖 freetype2 libjpeg  libpng libwebp libxml2 libzip zlib libzstd liblzma bzlib2
    //  lcms(默认不启用) libraw(默认不启用) libtiff(默认不启用) libjxl(默认不启用)

    install_libidn2($p);//依赖 intl libunistring ； (gettext库包含intl 、coreutils库包含libunistring );
    // //解决依赖 apk add  gettext  coreutils

    install_libssh2($p);
    install_nghttp2($p); //依赖 install_nghttp2($p);
    install_nghttp3($p); // 使用 GnuTLS或者wolfss，这样就不用更换openssl版本了 ；
    install_ngtcp2($p); //依赖gnutls nghttp3


    install_curl($p); //curl 依赖 openssl c-ares brotli libzstd idn(暂不启用) libidn2 libnghttp2 libnghttp3(暂不启用)

    //参考 https://github.com/docker-library/php/issues/221
    //install_pgsql($p);//依赖 openssl libxml2 libxslt  zlib readline icu libxml2 libxslt liblzma libiconv


    //扩展不兼容本项目
    //install_libmcrypt($p); //无 pkg-config 配置
    //扩展参数还需要调试
    //install_libxlsxwriter($p); //依赖zlib openssl （使用cmake，便于配置参数)
    //install_libexpat($p); //依赖zlib openssl （使用cmake，便于配置参数)
    //install_minizip($p);
    //install_libxlsxio($p); //依赖zlib openssl （使用cmake，便于配置参数)
    // Use libzip instead of Minizip

    //扩展不兼容本项目
    //install_libevent($p);


    # 扩展 mbstring 依赖 oniguruma 库
    # 扩展 intl 依赖 ICU 库
    # 扩展 gd 依赖 libpng，freetype 库 ；  freetype 依赖 zlib bzip2 libpng  brotli 等;  libwebp 依赖 giflib
    # 扩展 mongodb 依赖 openssl, zlib, ICU 等库
    # 本项目 opcache 是必装扩展，否则编译报错，不想启用opcache，需要修改源码: main/main.c
    # 本项目 swoole  是必装扩展，否则 sh make.sh archive 无法打包

    # php7 不支持openssl V3 ，PHP8 支持openssl V3 , openssl V3 默认库目录 /usr/openssl/lib64

    # label: build_path_bin , php_extension_patch , php_internal_extension , php_extension ,extension_library

    # pdo_pgsql,pdo_oci,pdo_odbc,ldap,ffi


    if ($p->getOsType() == 'win') {
        install_re2c($p);
    }

    if (0) {
        install_php_parser($p); //imagemagick 安装过程中需要
    }

    if (0) {
        install_php_internal_extensions($p); //安装内置扩展; ffi  pgsql pdo_pgsql
    }

    if ($p->getOsType() == 'macos') {
        if (0) {
            install_php_internal_extension_curl_patch($p); //修改 `ext/curl/config.m4` ，去掉 `HAVE_CURL` 检测
        }
    }

    //====================================
    ///      TEST  验证
    //====================================

    if (0) {
        install_libgcrypt_error($p); //依赖 libiconv libintl
        install_libgcrypt($p); //依赖 libgcrypt_error
        install_gnupg($p);  // GNU Privacy Guard  ; OpenPGP 标准的完整免费实现 依赖 libgcrypt
    }

    if (0) {
        install_zookeeper_client($p);
        install_unixodbc($p);
    }

    if (0) {
        install_php_extension_swow($p); // libcat for Swow https://github.com/libcat/libcat.git
        install_php_extension_micro($p);
        install_php_extension_zookeeper($p);
        install_php_extension_wasm($p);
        // install_php_extension_fastdfs($p);
    }

    install_nasm($p);
    install_dav1d($p); //AV1解码器dav1d  依赖 nasm : apk add nasm   //https://github.com/videolan/dav1d.git
    install_libgav1($p);
    install_libyuv($p); //libyuv是Google开源的yuv图像处理库，实现对各种yuv数据之间的转换，包括数据转换，裁剪，缩放，旋转
    install_aom($p);
    install_libavif($p); //依赖 libyuv dav1d
    install_libx264($p);
    install_numa($p); //把NUMA看作集群运算的一个紧密耦合的形式 https://baike.baidu.com/item/NUMA/6906025
    install_libx265($p);
    install_libde265($p);
    install_svt_av1($p);
    install_libheif($p); //依赖 libde265
    install_libtiff($p); //依赖  zlib libjpeg liblzma  libzstd
    install_libgd2($p);
    install_librsvg($p);

    if (0) {
        install_libtiff($p); //依赖  zlib libjpeg liblzma  libzstd
        install_lcms2($p); //lcms2  //依赖libtiff libjpeg zlib
        install_libraw($p);  //依赖 zlib  libjpeg liblcms2
        install_librsvg($p);
        install_libfribidi($p); //依赖 c2man
        //文本绘制引擎
        install_harfbuzz($p); //依赖ninja icu

        install_libde265($p);
        install_libheif($p); //依赖 libde265


        install_libOpenEXR($p); // 依赖Imath，不存在，会自动到github.com 下载
        install_highway($p);
        install_libjxl($p); //libgif libjpeg libopenexr libpng libwebp libbrotli highway

        install_graphite2($p);
        install_harfbuzz($p); //依赖ninja icu zlib glib


        //GraphicsMagick  http://www.graphicsmagick.org/index.html
        install_GraphicsMagick($p);
    }

    if (0) {
        install_xorgproto($p); //依赖 xorg-macros
        //install_xorg_macros($p);
        install_xorgproto($p);
        install_libX11($p);
        install_libXpm($p); //依赖 xorg-macros  xorgproto libx11 # apk add util-macros xorgproto libx11
    }

    install_libunistring($p); //coreutils需要  libiconv
    install_libintl($p); //coreutils 需要 libiconv
    install_gettext($p);// gettext 包含 intl
    install_coreutils($p);// gettext 包含 intl   GNU Core Utilities 包括常用的命令，如 cat、ls、rm、chmod、mkdir、wc、whoami 和许多其他命令
    install_gnulib($p);
    if (0) {
        install_openssl_v1($p);
        install_openssl_v3($p);
        install_openssl_v3_quic($p);
        install_libedit($p);


        install_libdeflate($p); //依赖 libzip zlib gzip
        install_bzip2_dev_latest($p);


        install_unbound($p); //依赖 libsodium nghttp2 nettle openssl ibtasn1 libexpat
        install_p11_kit($p);
        # TLS/ESNI/ECH/DoT/DoH/  参考文档https://zhuanlan.zhihu.com/p/572101957
        # SSL 比较 https://curl.se/docs/ssl-compared.html

        install_libtasn1($p);
        install_gnutls($p); //依赖 gmp libiconv  libtasn1 libzip  libzstd libbrotli libzlib
        install_nghttp3($p); // 使用 GnuTLS或者wolfss，这样就不用更换openssl版本了 ；
        install_libev($p); //无 pkg-config
        install_ngtcp2($p); //依赖gnutls nghttp3
        install_nghttp2($p); //依赖 install_nghttp2($p);
        install_boringssl($p);//需要golang

        install_wolfssl($p);//
        install_libressl($p);//

        install_jansson($p); //c json 库

        //参考 ：HTTP3 and QUIC 有多种实现   curl 使用 http3 参考： https://curl.se/docs/http3.html


        install_quiche($p); // 依赖 boringssl ，需要 rust ；
        install_msh3($p);  //需要安装库 bsd-compat-headers 解决 sys/queue.h 不存在的问题


        install_libfastcommon($p);
        install_libserverframe($p);
        install_fastdfs($p); //依赖 libfastcommon libserverframe


        install_libunwind($p); //使用 libunwind 可以很方便的获取函数栈中的内容，极大的方便了对函数间调用关系的了解。

        install_jemalloc($p);
        install_tcmalloc($p);


        install_libelf($p);
        install_libbpf($p); //libbpf 库是一个基于 C/C++ 的通用 eBPF 库

        install_snappy($p);
        install_kerberos($p);
        install_fontconfig($p);
        //install_pcre2($p);
        install_pgsql_test($p);

        // GCC 的 编译器都支持 OpenMP 和 OpenACC。
        // -fopenmp  -fopenmp-simd   -fopenacc
        //
        install_libgomp($p); //   OpenMP  OpenACC  https://gcc.gnu.org/projects/gomp/
        install_libzip_ng($p); //zlib next
    }
    install_snappy($p);

    if (0) {
        //Wasm
        //WebAssembly
        //Docker+Wasm  https://docs.docker.com/desktop/wasm/
    }

    //排版相关
    if (0) {
        //Linux_kernel_diagram   // https://makelinux.github.io/kernel/diagram/
        //  panzoom  用于向元素添加平移和缩放功能 https://timmywil.com/panzoom/demo/

        # apk add graphviz
        # pip3 install graphviz   -i https://pypi.tuna.tsinghua.edu.cn/simple
        //plantuml  https://plantuml.com/zh/

        //graphviz  https://www.graphviz.org/documentation/
        //graphviz  https://www.graphviz.org/doc/info/lang.html
        install_graphviz($p); //依赖git libwbp freetype
        //networkx    //https://github.com/networkx/networkx.git
        //graphviz 是一个专门用于可视化图状数据结构的工具包，而networkx是专门用于表示图状数据结构以及操作图状数据结构的工具包。
        // 工业级的还得用neo4j搭配graphx  面对巨量数据   https://www.cnblogs.com/jingjingxyk/p/16826546.html
        // draw.io  https://app.diagrams.net/

        // ASCIIFlow Infinity  https://asciiflow.com/
        // flowchart.js        http://flowchart.js.org/
        // js-sequence-diagrams by bramp  https://bramp.github.io/js-sequence-diagrams/

        install_TeX($p); //排版系统

        // geogebra 数学套件 https://www.geogebra.org/

        /*
            UML - Unified modeling language UML 统一建模语言

            泛化（Generalizations），聚合（aggregations）和关联（associations）
            分栏（Rectangle）

            依赖（Dependencies）

            跟踪（Traces）
            实现（Realizations）
            嵌套（Nestings）

         */
        /*
           生成器（iterabler)
           生成器（Generator)

         */
        /*
           享有数据分析“三剑客之一”的盛名（NumPy、Matplotlib、Pandas）
         */
    }
    if (0) {
        /*
            gsm
            alsa-lib
            opus
            libsamplerate
            jack
            portaudio
            speex
            speexdsp
            libsrtp
            pjproject
        */
    }

    install_rav1e($p);  //https://www.cnblogs.com/eguid/p/16015446.html
    if (0) {
        install_aom($p);
        install_av1($p);
        install_libvpx($p);
        install_libopus($p);
        install_libx264($p);
        install_libx265($p);
        install_mp3lame($p);
        install_ffmpeg($p);
        install_vlc($p);
        /*
        ffmpeg -encoders
        ffmpeg -decoders
        ffmpeg -codecs
        ffmpeg -formats
        ffmpeg -muxers
        ffmpeg -demuxers
        ffmpeg -protocols
        ffmpeg -filters
        */

        // install_librabbitmq($p);
        install_opencv_contrib($p);
        install_opencv($p); //构建过程中，会去github.com 下载 ippicv xfeatures2d wechat_qrcode unifont  face_landmark_model.dat
        //依赖ffmpeg zlib ninja zlib libjpeg libwebp freetype

        //A free, open source XR platform
        install_monado($p);// https://gitlab.freedesktop.org/monado/monado
    }
    if (0) {
        // 改善iptables/netfilter的规模瓶颈，提高Linux内核协议栈IO性能
        // DPDK让用户态程序直接处理网络流，bypass掉内核，使用独立的CPU专门干这个事。

        // Berkeley Packet Filter (eBPF)
        // XDP让灌入网卡的eBPF程序直接处理网络流，bypass掉内核，使用网卡NPU专门干这个事。
        // XDP的全称是： eXpress Data Path

        //  XDP 是Linux 内核中提供高性能、可编程的网络数据包处理框架。
        //  eBPF/XDP

        //SDN（Software Defined Networking） 它将网络控制层和数据层分离，使得网络可以通过软件进行灵活的配置和管理。
        //DPDK（Data Plane Development Kit） 它提供了一套高性能的数据包处理库和驱动程序，可以让应用程序直接访问网络设备，绕过操作系统的开销。
        // VPP（Vector Packet Processing）它基于DPDK实现了一个高性能的软件路由器和交换机，可以支持多种协议和功能。
        // FRR（Free Range Routing）是一个开源项目，它提供了一套路由协议的实现，包括BGP、OSPF、IS-IS等，可以与VPP集成，实现动态路由功能。
        install_dpdk($p); //ninja
        install_xdp($p);  //依赖 llvm bpftool
        //Underlay/Overlay 新技术
        install_ovs($p);  //依赖 openssl python3  ; 网络优化以来 dpdk
        install_ovn($p);
        install_FRR($p);  //路由协议栈 实现和管理各种 IPv4 和 IPv6 路由协议的免费软件 //https://github.com/FRRouting/frr.git
        //'https://www.bianyuanyun.com/wp-content/uploads/2021/06/whitepaper-未来网络白皮书——白盒交换机技术白皮书.pdf'

        //dpi(deep packet inspection)是一种基于数据包的深度检测技术，通过对网络关键点处的流量和报文内容进行检测分析，根据事先定义的策略对检测流量进行过滤控制，完成所在链路的业务精细化识别、业务流量流向分析、业务流量占比统计、业务占比整形、以及应用层拒绝服务攻击、对病毒/木马进行过滤和滥用p2p的控制等功能

        //eNSP(Enterprise Network Simulation Platform)是一款由华为提供的、可扩展的、图形化操作的网络仿真工具平台，主要对企业网络路由器、交换机进行软件仿真，完美呈现真实设备实景，支持大型网络模拟，让广大用户有机会在没有真实设备的情况下能够模拟演练，学习网络技术。
    }

    if (0) {
        install_qemu($p);
    }

    //分布式构建(Distributed Builds)
    if (0) {
        install_bazel($p);  //use bazel docker https://bazel.build/install/docker-container

        //install_icecream($p); //https://github.com/icecc/icecream.git

        //原理： 类似 SwarmAgent  （Agent/Coordinator ）  //https://docs.unrealengine.com/5.1/en-US/unreal-swarm-in-unreal-engine/
    }

    if ($p->getInputOption('with-valgrind') == 'yes') {
        install_valgrind($p); //Valgrind是一款用于内存调试、内存泄漏检测以及性能分析的软件开发工具。
    }
    if ($p->getInputOption('with-capstone') == 'yes') {
        install_capstone($p);
    }


    install_musl($p); //https://musl.libc.org/
    //解决依赖 apt install git build-essential
    // Automated cross toolchain builde
    install_musl_cross_make($p);

    if (0) {
        // brew  //  https://mirrors.tuna.tsinghua.edu.cn/help/homebrew
        // brew  //  https://github.com/Homebrew/brew.git
        //apk add ninja
        install_rust($p);
        install_nodejs($p);
        install_golang($p);
        install_depot_tools($p); //依赖python

        //install_ninja($p); //源码编译ninja，alpine 默认没有提供源；默认不安装 //依赖python
        //install_depot_tools($p); //依赖python
        //install_gn($p);//依赖python
        //install_gn_test($p);//源码编译GN

        // sanitizer  动态代码分析的工具
        // AddressSanitizer (ASan)，检测内存问题，包括了 LeakSanitizer
        // LeakSanitizer (LSan)，检测内存泄漏问题
        // ThreadSanitizer (TSan)，检测数据竞争问题
        // UndefinedBehaviorSanitizer (UBSsan)，检测未定义行为
        // MemorySanitizer (MSan)，检测未初始化内存问题

        // capstone 反汇编工具 http://www.capstone-engine.org/
        install_capstone($p);

        install_valgrind($p); //Valgrind是一款用于内存调试、内存泄漏检测以及性能分析的软件开发工具。

        //#if defined(HAVE_DISASM) || defined(HAVE_GDB) || defined(HAVE_OPROFILE) || defined(HAVE_PERFTOOLS) || defined(HAVE_VTUNE)
        //dynasm
        install_dynasm($p);

        //perf-tools简介一个开发中的Linux性能测试使用的工具,能够收集ftrace和perf_events中乱七八糟的参数。ftrace和perf都是Linux中的内核跟踪工具

        //op-agent  OpManager提供全面的网络监控功能，可帮助您监控网络性能，实时检测故障隐患

        //OProfile是Linux内核支持的一种性能分析机制。 它在时钟中断处理入口处建立监测点，记录被中断的上下文现场，由配套的用户态的工具oprof_start负责在用户态收集数据

        //alpine 上默认的 gcc 就是 musl-gcc
        //nm  结果参考 https://www.cnblogs.com/vaughnhuang/p/15771582.html
        // Linux库文件与可执行文件辅助工具集 https://juejin.cn/post/6844904150568796168
        // binutils 二进制工具集   gcc的ar,nm,objdump,objcopy
        // ar 参数： -c 告诉 ar 创建文件 (libsnappy.a)； -r 告诉 arto 替换可能重复的符号。（仅重新编译一些 .o 时有用）-s 相当于库上的ranlib
        // ar rcs $@ $^

        // gcc -Wall -Wextra -pedantic -pthread    # -pedanti 编译器严格遵守 C++ 标准 ； -Wextra（启用额外的警告信息，提高代码质量和安全性）
        //   -fno-ident  忽略`#ident'指令.


        //gdb bin/swoole-cli
        //set args -m
        //run

        // AR CC CXX CPP CFLAGS CXXFLAGS LDFLAGS LDLIBS 功能介绍
        // https://www.gnu.org/software/make/manual/html_node/Implicit-Variables.html

        // pstack命令(跟踪进程栈)

        //下载 boringssl 镜像地址 https://source.codeaurora.org/quic/lc

        //Vtune Threading Profiler是线程性能检测工具 , 分析负载平衡、同步开销过大等线程相关的性能问题

        //Perfdump 工具 Perfdump 是一个系统软件,当系统崩溃时,会调用它生成错误信息,供软件开发人员分析用


        // 动态链接库和静态链接库 https://www.cnblogs.com/Blog-c/p/7811190.html
        // .la 为libtool生成的共享库，其实是个配置文档。可以用file或者vim查看。
        // .ko 文件是Linux内核使用的动态链接文件后缀，属于模块文件，用在Linux系统启动时加载内核模块

        //  gcov是一个测试代码覆盖率的工具。 https://zhuanlan.zhihu.com/p/410077415

        // ca-certificates    /etc/ssl/certs  /etc/ca-certificates/update.d

        //build system type
        //host  system type
        //target system type    x86_64-unknown-linux-gnu

        // gcc -idirafter dir 在 -I 的目录里面查找失败, 讲到这个目录里面查找。

        // gcc -iprefix prefix  -iwithprefix dir 一般一起使用, 当 -I 的目录查找失败, 会到 prefix+dir 下查找
        // gcc -nostdinc -nostdinc++ 不搜索默认路径头文件
        // gcc -nostdlib 不使用标准库

        //clang main.c -static -nostdinc -nostdlib -I/usr/include/x86_64-linux-musl -L/usr/lib/x86_64-linux-musl
    }

    if (0) {
        install_grpc($p); //use protobuf  https://github.com/grpc/grpc.git
        install_thrift($p); //https://thrift.apache.org/
    }
    if (0) {
        install_boost($p);
    }
    if (0) {
        //申明式  和 命令式

        //一个为异构并行计算平台编写程序的工业标准  https://www.intel.com/content/www/us/en/docs/programmable/683846/22-1/opencl-library.html
        install_opencl($p); //OpenCL全称为Open Computing Language（开放计算语言） OpenCL不但支持数据并行，还支持任务并行
        //用于共享内存并行系统的多处理器程序设

        //metal，opencl   vulkan和metal除了通用计算，还能做渲染  ;
        // CUDA，OpenCL，Metal GPU加速有什么区别 更多信息 https://www.zhihu.com/question/481772259/answer/2762594628

        //Openmp和thread都是共享一个进程内存的并行，openmp最显著的特点是命令式(directive-based)语言
        //install_openmp($p);

        //并发编程：SIMD 介绍  https://zhuanlan.zhihu.com/p/416172020
        // SIMD 的全称是 Single Instruction Multiple Data，中文名“单指令多数据”。顾名思义，一条指令处理多个数据。
    }
    /*
    export PATH=$SYSTEM_ORIGIN_PATH
    export PKG_CONFIG_PATH=$SYSTEM_ORIGIN_PKG_CONFIG_PATH
    # 执行构建前

    # 执行构建操作

    # 执行构建后
    export PATH=$SWOOLE_CLI_PATH
    export PKG_CONFIG_PATH=$SWOOLE_CLI_PKG_CONFIG_PATH
    */

    /**
     * 交叉编译
     * --build=BUILD           configure for building on BUILD [BUILD=HOST]
     * --host=HOST             configure for HOST [guessed]
     * --target=TARGET         configure for TARGET [TARGET=HOST]
     */

    /**
     * BIO 全称Block-IO 是一种阻塞同步的通信模式 BIO 全称Block-IO 是一种阻塞同步的通信模式。我们常说的Stock IO 一般指的是BIO。是一个比较传统的通信方式，模式简单，使用方便。但并发处理能力低，通信耗时，依赖网速。
     * NIO 全称New IO，也叫Non-Block IO 是一种非阻塞同步的通信模式。
     * AIO 也叫NIO2.0 是一种非阻塞异步的通信模式。在NIO的基础上引入了新的异步通道的概念，并提供了异步文件通道和异步套接字通道的实现。
     * AIO 并没有采用NIO的多路复用器，而是使用异步通道的概念
     */

    /**
     * LC_ALL=C 是为了去除所有本地化的设置
     */

    /**
     * SYSTEM=`uname -s 2>/dev/null`
     * RELEASE=`uname -r 2>/dev/null`
     * MACHINE=`uname -m 2>/dev/null`
     *
     * PLATFORM="$SYSTEM:$RELEASE:$MACHINE";
     */

    /**
     * export CFLAGS="$(pkg-config  --cflags --static expat minizip ) "
     *
     * SET (CMAKE_EXE_LINKER_FLAGS "-static")
     *
     * target
     * ARCHIVE 静态库
     * LIBRARY 动态库
     * RUNTIME  可执行二进制文件
     *
     * # find_package的简单用法   https://blog.csdn.net/weixin_43940314/article/details/128252940
     * -D 从外部传入搜索路径：
     * <PackageName>_ROOT
     * <PackageName>_DIR
     *
     * c++(CMake篇)  https://zhuanlan.zhihu.com/p/470681241
     * # CMAKE_BUILD_TYPE=Debug Release
     *
     * cmake -G"Unix Makefiles" .  \
     * -DCMAKE_INSTALL_PREFIX={$libxlsxio_prefix} \
     * -DCMAKE_INSTALL_LIBDIR={$libminzip_prefix}/lib \
     * -DCMAKE_INSTALL_INCLUDEDIR={$libminzip_prefix}/include \
     * -DCMAKE_BUILD_TYPE=Release  \
     * -DBUILD_SHARED_LIBS=OFF  \
     * -DBUILD_STATIC_LIBS=ON \
     * -DCMAKE_COLOR_MAKEFILE=ON
     * -DCMAKE_REQUIRED_LIBRARIES="-L{$openssl_dir}/lib -lssl"
     * set(libgav1_root "${CMAKE_CURRENT_SOURCE_DIR}")
     * set(libgav1_build "${CMAKE_BINARY_DIR}")
     *
     * cmake -G 'Unix Makefiles' -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
     * cmake --build .
     * cmake --install .
     *
     * cmake -G 'Visual Studio 17 2022' -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
     * cmake --build . --config Release
     * cmake --install . --config Release
     *
     * CURL ARCHITECTURE   https://curl.se/docs/install.html#:~:text=26%20CPU%20Architectures
     * CURL Cross compile  https://curl.se/docs/install.html#:~:text=Cross%20compile
     *
     * cmake -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_C_COMPILER=clang -DCMAKE_C_FLAGS_RELWITHDEBINFO="-O1 -g -fsanitize=address,undefined -fno-sanitize-recover=all -fno-omit-frame-pointer" -DENABLE_SHARED=0 ..
     * export NUMCPUS=`grep -c '^processor' /proc/cpuinfo`
     *
     *
     *
     * make install DESTDIR=/usr/libzip
     */


    //Hot Module Replacement（以下简称 HMR） inotify

    /*
            CPPFLAGS="$(pkg-config  --cflags-only-I  --static libpng libjpeg dav1d libgav1)" \
            LDFLAGS="$(pkg-config --libs-only-L      --static libpng libjpeg dav1d libgav1)" \
            LIBS="$(pkg-config --libs-only-l         --static libpng libjpeg dav1d libgav1)" \

     */
    /*
         # https://mesonbuild.com/Builtin-options.html#build-type-options
         # meson configure build
         # meson wrap --help
        meson setup  build \
        -Dprefix={$xorgproto_prefix} \
        -Dbackend=ninja \
        -Dbuildtype=release \
        -Ddefault_library=static \
        -Db_staticpic=true \
        -Db_pie=true \
        -Dprefer_static=true
    */

    /*
     *
     生成共享库时不应使用 -pie。

    PIE：位置无关的可执行文件

    PIC：位置无关代码（共享库）

    请参阅下文以帮助您理解该问题：

    （注：-shared 与-fPIC/-fPIE 一起使用，-pie 与-fPIE/-fPIC 一起使用）

     */
    /*
        NUMA（Non Uniform Memory Access）技术可以使众多服务器像单一系统那样运转，同时保留小系统便于编程和管理的优点

    计算平台的体系结构  https://baike.baidu.com/item/NUMA/6906025
        当今数据计算领域的主要应用程序和模型可大致分为
        联机事务处理（OLTP）、
        决策支持系统（DSS）和企业信息通讯（BusinessCommunications）三大类。
        而小型独立服务器模式、SMP（对称多处理）模式、MPP（大规模并行处理）模式和NUMA模式，则是上述3类系统设计人员在计算平台的体系结构方面可以采用的选择。

        icecream
        SwarmAgent
     */

    /*
       debian 容器精简版本
       debian:bullseye-slim 或者 debian:stable-slim

        scratch scratch 镜像的第一个不便是没有 shell，这意味着 CMD/RUN 语句中不能使用字符串

     */
    /*
       linux内置的沙盒:Seccomp-bpf  内核安全技术,支持创建沙盒来限制进程可以进行的系统调用

    seccomp与capabilities的区别
         seccomp是比capabilities 更细粒度的capabilities权限限制系统内核提供的能力。
     */
    /*
      gcc 常见链接库
            （1）-lm：链接m动态库，即math数学库
            （2）-static –lm：链接m静态库
            （3）-ldl：当代码中用到dlopen，dlsym，dlclose，dlerror显示加载动态库时，需加上
            （4）-lstdc++：加上该编译选项表示编译c++文件，链接c++库
            （5）-lc：表示编译c文件，链接c库，gcc默认编译c文件和链接c库，当编译c文件时可以不用额外加该选项
            （6）-lpthread：链接到pthread的库
             (7) -lresolv DNS
     */
    /*
     *
        debian 使用 libc编译器
        组合一： musl-gcc g++
        组合二： clang clang++

        alpine 使用 libc编译器
        组合一： gcc g++   (gcc 默认就是musl-gcc)
        组合二： clang clang++
     */

    /*

       autoreconf -vfi
        -d 不删除临时文件
        -f 认为所有的文件都是过期的文件/强制执行
        -i 复制辅助文件
        -s 创建符号链接，而不是复制
        -m 当可用时，重新运行命令./configure 和 make
        -W 报告语法错误信息
     */

    /*
        envsubst 使用环境变量替换文件中的变量  模板文件
     */

    /*
       使用GCC时 Static link libstdc++
        -static-libgcc -static-libstdc++

       使用CLANG时 Static link libstdc++
        -static      # -static -lc++abi -pthread -fuse-ld=lld

        GNU libstdc++ 和 LLVM libc++ 是标准 C++ 库的两种不同实现。
     */

    /*

       export alias sh='bash'

     */
    /*
        php static compile
     */
    /*
       在Linux下，如何强制让GCC静态链接？
       https://www.zhihu.com/question/22940048
      https://zhuanlan.zhihu.com/p/377651202
     */
    /*


            ROS 2指南（十一）——交叉编译
            https://zhuanlan.zhihu.com/p/380174726
     */

    /*
    通过configure.ac文件生成copnfigure文件

    https://blog.csdn.net/mao834099514/article/details/79544467
    */
    /*
        gcc -ldl 选项作用  程序中使用dlopen、dlsym、dlclose、dlerror 显示加载动态库，需要设置链接选项 -ldl

        -lz   压缩库（Z）
        -lrt  实时库（real time）：shm_open系列
        -lm   数学库（math
        -lc   标准C库（C lib）
        -ldl  是显式加载动态库的动态函数库

    */

    /*
     *
    Available event backends: EPOLL;SELECT;POLL

    -- CMAKE_BINARY_DIR:         /work/thirdparty/libevent/build
    -- CMAKE_CURRENT_BINARY_DIR: /work/thirdparty/libevent/build
    -- CMAKE_SOURCE_DIR:         /work/thirdparty/libevent
    -- CMAKE_CURRENT_SOURCE_DIR: /work/thirdparty/libevent
    -- PROJECT_BINARY_DIR:       /work/thirdparty/libevent/build
    -- PROJECT_SOURCE_DIR:       /work/thirdparty/libevent
    -- CMAKE_MODULE_PATH:        /work/thirdparty/libevent/cmake/
    -- CMAKE_COMMAND:            /usr/bin/cmake
    -- CMAKE_ROOT:               /usr/share/cmake
    -- CMAKE_SYSTEM:             Linux-5.15.0-72-generic
    -- CMAKE_SYSTEM_NAME:        Linux
    -- CMAKE_SYSTEM_VERSION:     5.15.0-72-generic
    -- CMAKE_SYSTEM_PROCESSOR:   x86_64
    -- CMAKE_SKIP_RPATH:         NO
    -- CMAKE_VERBOSE_MAKEFILE:   FALSE
    -- CMAKE_C_FLAGS:             -Wall -Wextra -Wno-unused-parameter -Wstrict-aliasing -Wstrict-prototypes -fno-strict-aliasing -Wmissing-prototypes -Winit-self -Wmissing-field-initializers -Wdeclaration-after-statement -Waddress -Woverride-init -Wwrite-strings -Wno-unused-function
    -- CMAKE_BUILD_TYPE:         Release
    -- CMAKE_C_COMPILER:         /usr/bin/clang (id Clang, clang 1, GNUC 1)
    -- CMAKE_AR:                 /usr/bin/ar
    -- CMAKE_RANLIB:             /usr/bin/ranlib

     */
    /*
     *
        //as epoll/kqueue/event ports/inotify/eventfd/signalfd support

     */

    /*

      cmake -G --help
      cmake -G "Unix Makefiles"
      cmake -G "Ninja"

      # 查看可选项
      cmake -LH ..

    CMAKE_DISABLE_FIND_PACKAGE_ZLIB=TRUE
     */
    /*
         #  cmake默认查找到的是动态库 ; cmake 优先使用静态库
        #  参考 https://blog.csdn.net/10km/article/details/82931978

     */

    # cmake module example  https://github.com/ceph/ceph/tree/main/cmake/modules

    /*

export CC=/usr/local/bin/gcc
export CXX=/usr/local/bin/g++

# Without cache
set(CMAKE_C_COMPILER /usr/bin/clang)
set(CMAKE_CXX_COMPILER /usr/bin/clang++)

# With cache
set(CMAKE_C_COMPILER /usr/bin/clang CACHE PATH "")
set(CMAKE_CXX_COMPILER /usr/bin/clang++ CACHE PATH "")

# Force cache
set(CMAKE_C_COMPILER /usr/bin/clang CACHE PATH "" FORCE)
set(CMAKE_CXX_COMPILER /usr/bin/clang++ CACHE PATH "" FORCE)

cmake -GNinja -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++

set( COMPILER_BIN /opt/compiler/bin )


set(CMAKE_BUILD_TYPE "Debug")     # CMakeLists.txt中指定

SET(CMAKE_C_FLAGS "{$cflags}")
SET(CMAKE_CXX_FLAGS "{$cflags}")
SET(CMAKE_FIND_ROOT_PATH "{$root}")
SET(CMAKE_PREFIX_PATH "{$root}")

set(PKG_CONFIG_EXECUTABLE /bin/pkg-config
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)



cmake -D CMAKE_TOOLCHAIN_FILE=/path/to/toolchain_file.cmake ...

-DCMAKE_C_COMPILER=gcc
-DCMAKE_CXX_COMPILER=g++
-DCMAKE_BUILD_TYPE=Release
-DCMAKE_INSTALL_PREFIX=$prefix
-DCMAKE_INSTALL_LIBDIR=$prefix/lib
-DCMAKE_INSTALL_INCLUDEDIR=$prefix/include
-DBUILD_SHARED_LIBS=OFF
-DCMAKE_TOOLCHAIN_FILE=/user-x-cmake-toolchain.cmake
-DCMAKE_POLICY_DEFAULT_CMP0074=NEW
find_package(OpenSSL)
-DOpenSSL_ROOT=$openssL_install_dir
 或者
-DOpenSSL_DIR=$openssL_install_dir

-DCMAKE_DISABLE_FIND_PACKAGE_libsharpyuv=ON \
-DCMAKE_CXX_STANDARD=14
-DCMAKE_C_STANDARD=C11

-DCMAKE_C_COMPILER=$(quote "${1#*=}")";;
-DCMAKE_CXX_COMPILER=$(quote "${1#*=}")";;

-DCMAKE_C_FLAGS=$(quote "${1#*=}")";;
-DCMAKE_CXX_FLAGS=$(quote "${1#*=}")";;

-DCMAKE_CXX_STANDARD_LIBRARIES="-lm"

-DCMAKE_SHARED_LINKER_FLAGS

cmake -E env  CXXFLAGS="-Wall"

CMAKE_SYSROOT： 这个选项是用来设置目标平台根目录，会对编译和链接过程中，查找头文件和链接库造成影响。
例如：原本默认会从/usr/include目录中搜索头文件、从/usr/lib中搜索依赖库，当设置了–sysroot=dir（gcc是–sysroot，camek是CMAKE_SYSROOT) 后则会从dir/usr/include搜索头文件、从dir/usr/lib中搜索依赖库。

PKG_CONFIG_PATH ：指定依赖配置文件的绝对路径，就是存放.pc配置文件的地方

PKG_CONFIG_EXECUTABLE：指定pkg-config配置程序，作用是找到.pc文件，解析其内容，然后对底层构建工具（C/C++编译器、链接器）或高层构建工具（cmake）提供具体配置项目。通常是在POSIX系统（Linux，MacOS等）使用pkg-config，解决第三方依赖项配置问题。

以设置目标系统YOUR_TARGET_OS和目标版本YOUR_TARGET_ARCH



make install DESTDIR=



     */
    /*
       gcc link options:
                       https://gcc.gnu.org/onlinedocs/gcc/Link-Options.html
       cmake:

                       https://cmake.org/cmake/help/latest/index.html
     */

    /*
       gprof，打印出程序运行中各个函数消耗的时间，可以帮助程序员找出众多函数中耗时最多的函数。
       Gcov  查看代码覆盖率

     */

    /*
       CMAKE_EXE_LINKER_FLAGS
       CMAKE_MODULE_LINKER_FLAGS
       CMAKE_SHARED_LINKER_FLAGS
       CMAKE_STATIC_LINKER_FLAGS

        CMAKE_EXE_LINKER_FLAGS：设置可执行文件链接器的选项。
        CMAKE_SHARED_LINKER_FLAGS：设置共享库链接器的选项。
        CMAKE_MODULE_LINKER_FLAGS：设置模块链接器的选项。


        -DCMAKE_C_STANDARD_LIBRARIES="-lm -lcrypto -lssl -lopenssl" \
        -DCMAKE_REQUIRED_LIBRARIES="-L/usr/local/swoole-cli/mongo_c_driver/lib -latomic"


        -DCMAKE_EXE_LINKER_FLAGS=" -lm "
        -DCMAKE_STATIC_LINKER_FLAGS="-L{$openssl_prefix}/lib -lcrypto -lssl -lopenssl "

       #   -DCMAKE_MODULE_PATH="{$openssl_prefix}:{$openssl_prefix}"

        # 以分号 分割
        CMAKE_INCLUDE_PATH
        CMAKE_LIBRARY_PATH
        -- Searching for sasl/sasl.h
        --   Not found (specify -DCMAKE_INCLUDE_PATH=/path/to/sasl/include for SASL support)
        -- Searching for libsasl2
        --   Not found (specify -DCMAKE_LIBRARY_PATH=/path/to/sasl/lib for SASL support)

        -DCMAKE_PREFIX_PATH="{$libbson_prefix}"   https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html
        # 上面这两个路径给CMake的FIND__XXX()系列函数提供查找路径


        CMAKE_LIBRARY_PATH=/usr/local/openssl/lib:/usr/local/care/lib
        FIND_LIBRARY
        INCLUDE_DIRECTORIES=/usr/local/openssl/include:/usr/local/care/include

        INCLUDE_DIRECTORIES（添加头文件目录）
        LINK_DIRECTORIES（添加需要链接的库文件目录）
        LINK_LIBRARIES　（添加需要链接的库文件路径，注意这里是全路径 /usr/local/openssl/lib/libssl.so ） # 可以链接一个，也可以多个，中间使用空格分隔
        # https://www.cnblogs.com/binbinjx/p/5626916.html
        TARGET_LINK_LIBRARIES （设置要链接的库文件的名称）

        link_directories
        target_link_libraries
     */

    /*
     CMake常用语句：

        # 用于定义、修改变量
        set()
        # 设置工程
        project()
        # 用于添加可执行构建目标
        add_executable()
        # 用于添加库构建目标
        add_library()
        # 用于为构建目标设置构建规则和依赖
        target_include_directories()
        target_link_libraries()
        target_link_directories()
        target_link_options()
        target_compile_definitions()
        target_compile_features()
        target_compile_options()
        target_sources()
        # 设置目标属性
        set_target_properties()
        # 设置全局包含目录、库文件目录、库文件名
        include_directories()
        link_directories()
        link_libraries()
        # 查到包
        find_package()
        # 用于自动生成目录源文件集合
        aux_source_directory()
        # 添加子目录
        add_subdirectory()
     */

    /*
        autoheader
        libtoolize --force --copy
        aclocal
        automake -f --copy --add-missing
        autoconf


     */

    /*

        autotools 学习 文档： https://learnopengl.com/demo/autotools_tutorial.txt
        autoreconf -fi

        autotools主要由三个组件组成
        `autoconf`，它生成检测位置的“配置”脚本 使用的库允许重新配置构建系统；
        `automake`，生成 makefile
        `libtool`，它添加了一些功能来生成库（共享或 静止的）。我们不会处理那个人。

    */

    /*
       抽象语法树 AST  Abstract Syntax Tree
       PHP AST  https://github.com/nikic/PHP-Parser
       https://juejin.cn/post/6844904126099226631
     */

    /**
     * BPF CO-RE（编译一次 - 到处运行）
     */


    /*
     *
     C_INCLUDE_PATH      # 对预处理C有效
     CPLUS_INCLUDE_PATH  # 对预处理C++有效
     CPATH               # 对所有语言均有效

     */

    /*
        #找到动态链接库的路径
        LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/MyLib
        export LD_LIBRARY_PATH

        #找到静态库的路径
        LIBRARY_PATH=$LIBRARY_PATH:/MyLib
        export LIBRARY_PATH
     */


    /*

    查找标准头位置
    clang++ -v -xc++ -


    */

    /*
     *  SCTP（Stream Control Transmission Protocol，流控制传输协议  是一个 IP 协议之上的、可靠的、面向控制信令的、传输层协议
     *  TCP是以字节为单位传输的，SCTP是以数据块为单位传输的
     *  参考： https://zhuanlan.zhihu.com/p/639293225
     */

    /*
     * ABI  每个操作系统都会为运行在该系统下的应用程序提供应用程序二进制接口（Application Binary Interface，ABI）
     * EABI  嵌入式应用二进制接口 EABI（embedded application binary interface）
     */

    /*
      alpine 搜索 库构建命令
                 https://git.alpinelinux.org/aports/about/

      debian 搜索 库构建命令

     */

    /*
     * SLAM语言也称交替建模仿真语言
     */

    /*
     * 什么是IPoE？IPoE与PPPoE相比有哪些不同？
     * https://info.support.huawei.com/info-finder/encyclopedia/zh/IPoE.html
     *
     * PPPoE（Point-to-Point Protocol over Ethernet）
     *
     *  IPoE（IP over Ethernet）是一种接入认证技术
     *
     * 在IPoE中，用户通过DHCP（Dynamic Host Configuration Protocol，动态主机配置协议）动态获取IP地址
     *
     * 宽带接入服务器（Broadband Remote Access Server,简称BRAS）是面向宽带网络应用的新型接入网关
     *
     * IPSec（IP Security Protocol）
     * VoIP（Voice over IP)
     */

    /*
     *  Valgrind、Address Sanitizer（ASan）内存分析工具
     */
}