四大体系一次讲透。每一节都是 完整流程 + 完整代码 +
  大白话，能直接抄去用。统一原则不变：能用标准工具就用标准工具，兼容/转换靠官方自带，绝不自研轮子。

  ---
  一、PHP 信创环境性能优化与兼容性治理体系

  1.1 大白话先讲清楚问题

  信创环境 = 国产CPU（ARM/龙芯）+ 国产OS（麒麟/统信UOS）+ 国产数据库/中间件。PHP 跑上去的三大坑：
  - 性能掉：ARM/龙芯单核比 x86 弱，得靠编译优化 + OPcache + JIT 补回来。
  - 兼容崩：扩展是 x86 编译的、.so 加载不了；字节序/对齐问题。
  - 行为变：不同库 SQL 方言、时区、字符集不一致。

  治理思路：统一基线（OPcache+JIT）→兼容性扫描（不自研，用官方工具）→灰度验证。

  1.2 性能优化核心：OPcache + JIT 完整配置

  ; php.ini ——信创环境通用高性能基线（ARM/龙芯同样适用）
  [opcache]
  opcache.enable=1
  opcache.enable_cli=1
  opcache.memory_consumption=512          ; 字节码缓存内存，按机器调大
  opcache.interned_strings_buffer=64
  opcache.max_accelerated_files=100000    ; 文件多就调大，必须是质数附近
  opcache.validate_timestamps=0           ; 生产关掉时间戳校验，最快（改代码要手动 reload）
  opcache.save_comments=1                 ; 注解框架(如Doctrine)依赖注释，别关
  opcache.huge_code_pages=1               ; 大页内存，ARM 上提升明显

  ; JIT ——PHP8 提速关键，计算密集型收益大
  opcache.jit=tracing                     ; tracing 模式综合最优
  opcache.jit_buffer_size=256M

  ; 预加载 ——把框架核心类常驻内存，省去每次加载
  opcache.preload=/var/www/preload.php
  opcache.preload_user=www-data

  预加载脚本（把热点类提前编译进内存）：

  <?php
  // /var/www/preload.php ——大白话：开机就把框架核心类装进内存，请求来了直接用
  $dir = '/var/www/app/vendor';

  // Composer 自动加载的类全部预热（最省事的最优解）
  opcache_compile_file($dir . '/autoload.php');

  // 递归预编译框架核心目录
  $it = new RecursiveIteratorIterator(
      new RecursiveDirectoryIterator($dir . '/laravel/framework/src')
  );
  foreach ($it as $file) {
      if ($file->getExtension() === 'php') {
          // 用 opcache_compile_file 而非 require，避免依赖未满足报错
          @opcache_compile_file($file->getRealPath());
      }
  }

  大白话： validate_timestamps=0 + preload + jit=tracing 这三件套，是信创环境把 PHP 性能拉满的最优组合。代价是改代码后要
  systemctl reload php-fpm。

  1.3 兼容性治理：全部用官方/社区成熟工具，不自研

  # 1) 扩展兼容性体检——用PHP 官方推荐的 php-compatibility 规则集（PHPCS）
  composer require --dev phpcompatibility/php-compatibility
  vendor/bin/phpcs -p ./src \
    --standard=vendor/phpcompatibility/php-compatibility/PHPCompatibility \
    --runtime-set testVersion 8.2     # 目标版本，自动报哪段代码不兼容

  # 2) 看当前装了哪些扩展、是不是本架构编译的
  php -m
  php -i | grep -i 'architecture\|uname'

  # 3) 用 ldd 检查 .so 依赖是否齐全（ARM/龙芯常见缺库）
  ldd $(php-config --extension-dir)/redis.so

  兼容性治理流程（大白话）：
  1. php-compatibility 扫源码 →找出用了高版本/废弃语法的地方（不自研，社区标准）。
  2. php -m + ldd 扫扩展 →找出加载失败的 .so，全部用源码在本架构重编（见第二节）。
  3. 方言差异用上一轮的 Db 统一层兜底 + 数据库兼容模式解决，不在 PHP 写翻译。

  ---
  二、国产CPU架构 PHP 编译与优化体系（鲲鹏/飞腾/龙芯）

  2.1 大白话：为什么必须自己编译

  - 鲲鹏/飞腾 = ARM64（aarch64），龙芯新款 = LoongArch，老款 = MIPS64。
  - 网上下载的 PHP/扩展大多是 x86 二进制，根本装不上。
  - 必须用本架构的 GCC 从源码编译，并开架构专属优化参数。

  2.2 各架构最优编译参数（关键差异就在 CFLAGS）

  # ===== 通用：先装编译依赖（麒麟/UOS 用 yum 或 apt）=====
  yum install -y gcc make autoconf libxml2-devel sqlite-devel \
    openssl-devel libcurl-devel oniguruma-devel libzip-devel

  # ===== 鲲鹏（Kunpeng 920，ARM64）=====
  # 大白话：-mcpu 直接告诉编译器“按鲲鹏的指令集优化”，比通用ARM 快一截
  export CFLAGS="-O2 -mcpu=tsv110 -mtune=tsv110 -fno-semantic-interposition"

  # ===== 飞腾（FT-2000/腾锐 D2000，ARM64）=====
  export CFLAGS="-O2 -mcpu=cortex-a72 -mtune=cortex-a72 -fno-semantic-interposition"

  # ===== 龙芯（3A5000/3C5000，LoongArch）=====
  export CFLAGS="-O2 -march=loongarch64 -mtune=la464 -fno-semantic-interposition"

  # ===== 统一编译 PHP（三种架构编译步骤一样，只是 CFLAGS 不同）=====
  ./configure \
    --prefix=/usr/local/php \
    --enable-fpm \
    --enable-opcache \
    --with-openssl \
    --with-curl \
    --enable-mbstring \
    --with-zlib \
    --enable-sockets \
    --enable-pcntl \
    --with-pdo-mysql \       # OceanBase 用
    --with-pdo-pgsql \       # 金仓用
    --enable-jit             # 开 JIT
  make -j$(nproc)            # 多核并行编译，跑满CPU
  make install

  大白话解释参数：
  - -mcpu=tsv110：鲲鹏920 的内核代号，让 GCC 生成专属指令，比 -march=armv8-a 通用版快。
  - -fno-semantic-interposition：允许函数内联优化，PHP 这种大量小函数的程序提升明显。
  - -O2 而不是 -O3：-O3 在 ARM/龙芯上偶发不稳定，-O2 是稳定与性能的最优平衡。
  - make -j$(nproc)：用满所有核编译，省时间。

  2.3 扩展编译（同架构重编，解决 .so 加载失败）

  # 以 redis 扩展为例：必须在本架构用 pecl/源码重编
  /usr/local/php/bin/pecl install redis
  # 或源码：
  git clone https://github.com/phpredis/phpredis
  cd phpredis && /usr/local/php/bin/phpize
  ./configure --with-php-config=/usr/local/php/bin/php-config
  make -j$(nproc) && make install
  # php.ini 加： extension=redis.so

  # 验证扩展确实是本架构的
  file /usr/local/php/lib/php/extensions/*/redis.so
  # 输出应是 aarch64 / LoongArch，不是 x86-64

  2.4 验证优化是否生效

  # 确认 JIT 真的开了
  php -r 'var_dump(opcache_get_status()["jit"]["on"]);'   # 应为 true

  # 确认架构正确
  php -r 'echo php_uname("m"), PHP_EOL;'   # aarch64 / loongarch64

  优化体系小结（大白话）： 三个架构编译流程完全一样，唯一区别是 CFLAGS 那一行。开 -mcpu/-march 专属优化 + JIT +
  多核编译，就是国产CPU上 PHP 性能的最优解。

  ---
  三、PHP 信创项目验收标准与测试体系

  3.1 验收四大维度（大白话：验收就查这四样）

  ┌──────┬────────────────────────────────┬───────────────────────────────────┐
  │ 维度 │            验收标准            │ 用什么工具（全官方/成熟，不自研） │
  ├──────┼────────────────────────────────┼───────────────────────────────────┤
  │ 功能 │ 国产环境下业务结果与 x86 一致  │ PHPUnit（单元/集成测试）          │
  ├──────┼────────────────────────────────┼───────────────────────────────────┤
  │ 兼容 │ 全栈纯国产（CPU+OS+DB+中间件） │ php -m / ldd / php-compatibility  │
  ├──────┼────────────────────────────────┼───────────────────────────────────┤
  │ 性能 │ QPS/响应达标，不低于约定基线   │ ab / wrk / JMeter 压测            │
  ├──────┼────────────────────────────────┼───────────────────────────────────┤
  │ 安全 │ 无注入/越权，依赖无高危漏洞    │ composer audit / OWASP 扫描       │
  └──────┴────────────────────────────────┴───────────────────────────────────┘

  3.2 功能验收：PHPUnit 完整示例

  <?php
  // tests/CrossDbTest.php ——大白话：同一份测试，分别连国产库跑，结果必须一致
  use PHPUnit\Framework\TestCase;

  final class CrossDbTest extends TestCase
  {
      public static function dbProvider(): array
      {
          return [
              'OceanBase' => ['oceanbase',
  ['host'=>'127.0.0.1','port'=>2881,'database'=>'test','user'=>'root@test','password'=>'x']],
              'Kingbase'  => ['kingbase',
  ['host'=>'127.0.0.1','port'=>54321,'database'=>'test','user'=>'system','password'=>'x']],
              'DM'        => ['dm',        ['host'=>'127.0.0.1','port'=>5236,'user'=>'SYSDBA','password'=>'x']],
          ];
      }

      /** @dataProvider dbProvider */
      public function testInsertAndQuery(string $type, array $cfg): void
      {
          $db = Db::connect($type, $cfg);
          $db->execute("DELETE FROM t_user WHERE name = ?", ['信创']);
          $db->execute("INSERT INTO t_user(name, age) VALUES(?, ?)", ['信创', 30]);

          $row = $db->first("SELECT name, age FROM t_user WHERE name = ?", ['信创']);

          // 验收点：三个国产库返回结果必须一致
          $this->assertSame('信创', $row['name']);
          $this->assertEquals(30, (int)$row['age']);
      }
  }

  vendor/bin/phpunit tests/   # 一条命令把三个国产库都验一遍

  3.3 性能验收：标准压测脚本

  # 用 ab 压测（最简单），或 wrk（更准）
  # 验收标准示例：QPS≥2000，P99≤200ms
  ab -n 50000 -c 200 http://127.0.0.1/api/order

  # wrk 更专业，输出延迟分布
  wrk -t8 -c200 -d60s --latency http://127.0.0.1/api/order

  3.4 安全 + 依赖验收

  # Composer 自带的漏洞审计（不自研，官方功能）
  composer audit                # 扫第三方包已知高危漏洞

  # 静态安全分析
  composer require --dev vimeo/psalm
  vendor/bin/psalm --taint-analysis   # 自动找注入/污点传播

  验收体系小结： 功能用 PHPUnit 跨库数据驱动保证一致；性能用 wrk/ab 卡基线；安全用 composer audit +
  psalm。出一份四维报告就是合格的信创验收文档，全程零自研工具。

  ---
  四、PHP 国产化中间件适配与落地体系

  4.1 大白话：中间件怎么换

  ┌────────────────┬─────────────────────────────────────────────┬─────────────────┬───────────────────────┐
  │    原中间件    │                  国产替代                   │   协议兼容？    │      PHP 怎么连       │
  ├────────────────┼─────────────────────────────────────────────┼─────────────────┼───────────────────────┤
  │ Redis          │ TongRDS / 阿里Tair / 华为GaussDB(for Redis) │ Redis 协议兼容  │ phpredis 原样用       │
  ├────────────────┼─────────────────────────────────────────────┼─────────────────┼───────────────────────┤
  │ RabbitMQ/Kafka │ TongLINK/Q、东方通 MQ、华为DMS              │ AMQP/Kafka 协议 │ php-amqplib / rdkafka │
  ├────────────────┼─────────────────────────────────────────────┼─────────────────┼───────────────────────┤
  │ Nginx          │ TongWeb / 东方通 Web、或 OpenResty          │ HTTP            │ FPM 配置不变          │
  ├────────────────┼─────────────────────────────────────────────┼─────────────────┼───────────────────────┤
  │ Tomcat(配套)   │ 东方通 TongWeb、宝兰德 BES                  │ —              │ PHP 侧无关            │
  └────────────────┴─────────────────────────────────────────────┴─────────────────┴───────────────────────┘

  核心思路：国产中间件大多“协议兼容”，PH客户端库不用换，只换连接地址 + 少量参数。

  4.2 国产 Redis（协议兼容）适配代码

  <?php
  // 大白话：TongRDS/Tair 都兼容 Redis 协议，phpredis 直接连，代码零改动
  $redis = new Redis();
  $redis->connect('127.0.0.1', 6379);   // 换成国产Redis的地址即可
  $redis->auth('password');

  $redis->setex('order:1001', 3600, json_encode(['amount' => 99]));
  $cache = $redis->get('order:1001');

  // 集群版（国产 Redis 多为集群）用 RedisCluster，同样原生支持
  $cluster = new RedisCluster(null, ['10.0.0.1:6379', '10.0.0.2:6379']);
  $cluster->set('k', 'v');

  4.3 国产消息队列（AMQP 兼容）适配代码

  <?php
  // 用官方推荐的 php-amqplib（纯PHP，最稳，无需扩展）
  // 东方通 TongLINK/Q、部分国产MQ 兼容 AMQP，换地址即可
  use PhpAmqpLib\Connection\AMQPStreamConnection;
  use PhpAmqpLib\Message\AMQPMessage;

  $conn = new AMQPStreamConnection('国产MQ地址', 5672, 'user', 'pass', 'vhost');
  $ch   = $conn->channel();
  $ch->queue_declare('order_queue', false, true, false, false);

  // 生产
  $ch->basic_publish(
      new AMQPMessage(json_encode(['order_id'=>1001]), ['delivery_mode'=>2]),
      '', 'order_queue'
  );

  // 消费
  $ch->basic_consume('order_queue', '', false, false, false, false,
      function (AMQPMessage $msg) {
          $data = json_decode($msg->body, true);
          // ... 处理业务
          $msg->ack();   // 手动确认，防丢消息
      });
  while ($ch->is_open()) { $ch->wait(); }

  4.4 国产 Web 中间件（东方通 TongWeb / OpenResty）落地

  # 东方通/OpenResty 反代 PHP-FPM ——配置和标准 Nginx 一致
  server {
      listen 80;
      server_name app.local;
      root /var/www/app/public;
      index index.php;

      location / { try_files $uri $uri/ /index.php?$query_string; }

      location ~ \.php$ {
          fastcgi_pass 127.0.0.1:9000;       # 连 PHP-FPM
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }

  4.5 中间件适配落地流程（大白话五步）

  1. 盘点：列出现有中间件 →找对应国产替代（优先选协议兼容的）。
  2. 换库优先级：协议兼容的（Redis/AMQP/Kafka）→PHP客户端不动，只改地址。
  3. 连通性测试：先用最小脚本连通，再接业务。
  4. 降级兜底：MQ/缓存加超时和重试，国产中间件初期稳定性兜底。
  5. 压测验收：用第三节的 wrk/PHPUnit 跑一遍，确认无功能/性能回退。

  ---
  全局总结（四大体系一张图）

  信创 PHP 落地 = 四根支柱

  ①性能与兼容治理 →OPcache+JIT+preload 提速；php-compatibility 扫兼容（不自研）
  ②CPU 编译优化   →本架构 GCC + 专属 CFLAGS(-mcpu/-march) + JIT，扩展全部重编
  ③验收测试体系   →PHPUnit跨库一致性 + wrk压测 + composer audit 安全（全官方工具）
  ④中间件适配     →优先协议兼容(Redis/AMQP)，PHP客户端不换，只改地址

  一句话最优方案： 性能靠 JIT+OPcache+preload，CPU 靠本架构专属编译参数，验收靠 PHPUnit+wrk+composer
  audit，中间件靠协议兼容直连——全栈用官方/成熟工具，零自研翻译与轮子，这就是PHP 信创落地最稳最快的体系。

  需要我把某一块（比如龙芯 LoongArch 的完整 PHP 编译实操、或国产 Kafka 用 rdkafka
  的完整生产消费代码）再展开成可直接跑的脚本吗？