统信UOS/麒麟系统下PHP源码编译安装与信创环境环境搭建手册=php信创

一、搞清楚你的环境必看 在开始之前先搞清楚自己是什么系统、什么架构后面的命令才能选对。# 查系统版本cat/etc/os-release# 查 CPU 架构重要uname-m# 输出 x86_64 → 普通 Intel/AMD 处理器# 输出 aarch64 → ARM64鲲鹏/飞腾/龙芯等信创处理器# 查内核版本uname-r# 查内存和 CPU 核数后面编译用nproc# CPU 核数free-h# 内存大小系统和包管理器对应关系 ┌──────────────────┬─────────────────┬────────────┐ │ 系统 │ 版本 │ 包管理器 │ ├──────────────────┼─────────────────┼────────────┤ │ 统信UOS 桌面版 │ V20 │apt│ ├──────────────────┼─────────────────┼────────────┤ │ 统信UOS 服务器版 │ V20 │apt│ ├──────────────────┼─────────────────┼────────────┤ │ 麒麟 Kylin │ V10 桌面/服务器 │apt或 yum │ ├──────────────────┼─────────────────┼────────────┤ │ 麒麟 Kylin │ V4 │ yum │ └──────────────────┴─────────────────┴────────────┘# 判断用哪个包管理器whichapt# 有输出就用 aptwhichyum# 有输出就用 yumwhichdnf# 有输出就用 dnf新版麒麟--- 二、系统准备2.1配置软件源信创系统经常需要手动配# 统信UOS 配置软件源 # 备份原有源cp/etc/apt/sources.list /etc/apt/sources.list.bak# 统信UOS 官方源根据实际版本调整cat/etc/apt/sources.listEOFdeb[by-hashforce]https://professional-packages.chinauos.com/desktop-professional eagle main contrib non-free deb[by-hashforce]https://professional-packages.chinauos.com/desktop-professional eagle/sp3 main contrib non-free EOF# 更新源aptupdate# 麒麟 Kylin V10 配置软件源apt版cat/etc/apt/sources.listEOFdeb http://archive.kylinos.cn/kylin/KYLIN-ALL10.1main restricted universe multiverse EOFaptupdate# 麒麟 Kylin V10 配置软件源yum版# 查看现有 repo 文件ls/etc/yum.repos.d/# 如果没有可用源手动添加cat/etc/yum.repos.d/kylin.repoEOF[kylin-base]nameKylin Linux Basebaseurlhttp://archive.kylinos.cn/yum/v10/enabled1gpgcheck0EOF yum makecache2.2安装编译工具链# apt 系统统信UOS / 麒麟apt版aptupdateaptupgrade-y# 编译必须的工具aptinstall-y\build-essential\# gcc g make 等基础编译工具gcc\g\make\cmake\autoconf\# 自动配置工具automake\libtool\pkg-config\# 库路径查找工具bison\# PHP 语法解析器生成工具必须re2c\# PHP 词法分析器生成工具必须wget\curl\git\vim\unzip# yum/dnf 系统麒麟yum版yum update-y# 安装开发工具组一次装好所有编译工具yum groupinstall-yDevelopment Tools# 额外必须的工具yuminstall-y\gcc\gcc-c\make\cmake\autoconf\automake\libtool\pkgconfig\bison\re2c\wget\curl\git\vim\unzip--- 三、安装 PHP 编译依赖库 大白话PHP 有很多功能图片处理、加密、数据库连接等每个功能都需要对应的系统库。编译前必须把这些库的开发版本带-dev或-devel后缀装好。3.1apt系统统信UOS / 麒麟apt版aptinstall-y\# XML 支持PHP 必须libxml2-dev\# SSL/HTTPS 支持 libssl-dev\openssl\# cURL 支持HTTP请求libcurl4-openssl-dev\# 图片处理 libjpeg-dev\# JPEG 图片libpng-dev\# PNG 图片libwebp-dev\# WebP 图片libfreetype6-dev\# 字体渲染验证码等libavif-dev\# AVIF 图片PHP 8.1# 数据库 libmysqlclient-dev\# MySQL 客户端库default-libmysqlclient-dev\libsqlite3-dev\# SQLite# 字符串处理 libonig-dev\# 多字节字符串mbstring 必须# 压缩 zlib1g-dev\# zlib 压缩libzip-dev\# ZIP 文件支持libbz2-dev\# BZ2 压缩# 加密 libsodium-dev\# 现代加密库libargon2-dev\# 密码哈希# 其他 libreadline-dev\# 命令行编辑libedit-dev\libgmp-dev\# 大数运算libldap2-dev\# LDAP 认证libpq-dev\# PostgreSQLlibxslt1-dev\# XSLT 转换libgd-dev# GD 图形库备用3.2yum/dnf 系统麒麟yum版 yuminstall-y\# XML 支持 libxml2-devel\# SSL/HTTPS openssl-devel\openssl\# cURL libcurl-devel\# 图片处理 libjpeg-turbo-devel\libpng-devel\libwebp-devel\freetype-devel\# 数据库 mysql-devel\mariadb-devel\sqlite-devel\# 字符串 oniguruma-devel\# 压缩 zlib-devel\libzip-devel\bzip2-devel\# 加密 libsodium-devel\# 其他 readline-devel\gmp-devel\openldap-devel\postgresql-devel\libxslt-devel\gd-devel3.3验证关键库是否安装成功# 检查库是否存在以 openssl 为例pkg-config--existsopensslechoopenssl: OK||echoopenssl: 缺失pkg-config--existslibcurlechocurl: OK||echocurl: 缺失pkg-config--existsonigurumaechooniguruma: OK||echooniguruma: 缺失pkg-config--existslibzipecholibzip: OK||echolibzip: 缺失# 查找库文件位置ldconfig-p|greplibssl ldconfig-p|greplibmysqlclient --- 四、下载 PHP 源码# 创建工作目录mkdir-p/opt/php-buildcd/opt/php-build# 方法1从官网下载需要能访问外网PHP_VERSION8.3.7wgethttps://www.php.net/distributions/php-${PHP_VERSION}.tar.gz# 方法2从国内镜像下载推荐速度快# 清华镜像wgethttps://mirrors.tuna.tsinghua.edu.cn/php/php-${PHP_VERSION}.tar.gz# 解压tar-xzfphp-${PHP_VERSION}.tar.gzcdphp-${PHP_VERSION}# 查看目录结构了解一下ls# 重要目录:# configure → 配置脚本我们要运行这个# ext/ → PHP 扩展源码# sapi/ → PHP 运行模式fpm、cli等# Zend/ → PHP 引擎核心--- 五、配置编译选项最关键的一步 大白话./configure 就是告诉编译器我要哪些功能、装到哪里。5.1x86_64 架构配置统信UOS x86版 / 麒麟x86版cd/opt/php-build/php-8.3.7 ./configure\--prefix/usr/local/php\# PHP 安装到这个目录--with-config-file-path/usr/local/php/etc\# php.ini 放这里--with-config-file-scan-dir/usr/local/php/etc/php.d\# 额外配置目录# 运行模式 --enable-fpm\# 开启 PHP-FPMWeb服务必须--with-fpm-userwww\# PHP-FPM 运行用户--with-fpm-groupwww\# PHP-FPM 运行组--enable-cli\# 命令行模式# 字符串和编码 --enable-mbstring\# 多字节字符串中文必须--with-iconv\# 字符编码转换# 网络和加密 --with-openssl\# SSL/HTTPS 支持--with-curl\# cURL HTTP 请求--enable-sockets\# Socket 支持# 数据库 --with-pdo-mysql\# PDO MySQL推荐方式--with-mysqli\# MySQLi 扩展--with-pdo-sqlite\# PDO SQLite--with-sqlite3\# SQLite3# 图片处理 --enable-gd\# GD 图形库--with-freetype\# 字体支持--with-jpeg\# JPEG 支持--with-webp\# WebP 支持# 压缩 --with-zlib\# zlib 压缩--enable-zip\# ZIP 文件--with-bz2\# BZ2 压缩# 性能优化 --enable-opcache\# OPcache 字节码缓存必须开--enable-pcntl\# 进程控制Swoole等需要--enable-posix\# POSIX 函数# 其他常用 --enable-bcmath\# 高精度数学--enable-calendar\# 日历函数--with-gmp\# 大数运算--enable-exif\# 图片EXIF信息--with-sodium\# 现代加密--with-password-argon2\# 密码哈希--enable-intl\# 国际化--with-readline\# 命令行编辑# 编译优化 --disable-debug\# 关闭调试生产环境--disable-rpath# 不硬编码库路径5.2ARM64/aarch64 架构配置鲲鹏/飞腾/麒麟ARM版# ARM64 需要额外设置编译器标志exportCCgccexportCXXg# ARM64 优化编译标志# -marcharmv8-a → 针对 ARMv8 架构优化# -O2 → 二级优化速度和大小平衡# -pipe → 用管道代替临时文件加快编译exportCFLAGS-O2 -pipe -marcharmv8-aexportCXXFLAGS-O2 -pipe -marcharmv8-a# 鲲鹏处理器可以用更激进的优化# export CFLAGS-O3 -pipe -marcharmv8.2-acryptofp16rcpcdotprod./configure\--prefix/usr/local/php\--with-config-file-path/usr/local/php/etc\--with-config-file-scan-dir/usr/local/php/etc/php.d\# ARM64 专用指定目标架构 --hostaarch64-linux-gnu\--buildaarch64-linux-gnu\# 运行模式 --enable-fpm\--with-fpm-userwww\--with-fpm-groupwww\--enable-cli\# 字符串和编码 --enable-mbstring\--with-iconv\# 网络和加密 --with-openssl\--with-curl\--enable-sockets\# 数据库 --with-pdo-mysql\--with-mysqli\--with-pdo-sqlite\--with-sqlite3\# 图片处理 --enable-gd\--with-freetype\--with-jpeg\--with-webp\# 压缩 --with-zlib\--enable-zip\--with-bz2\# 性能优化 --enable-opcache\--enable-pcntl\--enable-posix\# 其他 --enable-bcmath\--enable-calendar\--with-gmp\--enable-exif\--with-sodium\--with-password-argon2\--enable-intl\--with-readline\# 编译优化 --disable-debug\--disable-rpath5.3configure 常见报错和解决方法# 报错1configure: error: Cannot find OpenSSL # 原因openssl 开发库没装aptinstall-ylibssl-dev# apt 系统yuminstall-yopenssl-devel# yum 系统# 如果装了还报错手动指定路径--with-openssl/usr/local/openssl# 报错2configure: error: oniguruma not found # 原因mbstring 依赖的 oniguruma 库没装aptinstall-ylibonig-dev yuminstall-yoniguruma-devel# 报错3configure: error: Please reinstall the libzip aptinstall-ylibzip-dev yuminstall-ylibzip-devel# 如果版本太旧需要手动编译 libzipcd/tmpwgethttps://libzip.org/download/libzip-1.10.1.tar.gztarxzf libzip-1.10.1.tar.gzcdlibzip-1.10.1mkdirbuildcdbuild cmake..-DCMAKE_INSTALL_PREFIX/usr/localmake-j$(nproc)makeinstall# 然后告诉 pkg-config 去哪找exportPKG_CONFIG_PATH/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH# 报错4configure: error: Cannot find libmysqlclient aptinstall-ydefault-libmysqlclient-dev yuminstall-ymysql-devel mariadb-devel# 报错5ARM64 报 unsupported architecture # 确认 gcc 支持 aarch64gcc-v21|grepTarget# 应该输出: Target: aarch64-linux-gnu# 如果不对安装交叉编译工具aptinstall-ygcc-aarch64-linux-gnu# 报错6bison 版本太低 bison--version# 需要 3.0# 如果版本太低手动安装cd/tmpwgethttps://ftp.gnu.org/gnu/bison/bison-3.8.2.tar.gztarxzf bison-3.8.2.tar.gzcdbison-3.8.2 ./configure--prefix/usr/localmake-j$(nproc)makeinstallexportPATH/usr/local/bin:$PATH--- 六、编译和安装cd/opt/php-build/php-8.3.7# 第一步编译 # -j$(nproc) 表示用所有 CPU 核并行编译速度更快# 大白话nproc 输出你有几个核比如 8 核就是 make -j8make-j$(nproc)# 编译过程大概需要 5~20 分钟取决于机器性能# 看到最后输出 Build complete. 就成功了# 如果编译报错先清理再重来# make clean → 清理编译产物# make distclean → 彻底清理连 configure 结果也清# 第二步安装 makeinstall# 安装完成后检查ls/usr/local/php/# 应该看到: bin/ etc/ include/ lib/ sbin/ var//usr/local/php/bin/php-v# 应该输出 PHP 8.3.7 (cli) ...# 第三步配置环境变量 # 让系统能直接用 php 命令不用写完整路径# 方法1软链接简单直接ln-sf/usr/local/php/bin/php /usr/local/bin/phpln-sf/usr/local/php/bin/phpize /usr/local/bin/phpizeln-sf/usr/local/php/bin/php-config /usr/local/bin/php-configln-sf/usr/local/php/sbin/php-fpm /usr/local/sbin/php-fpm# 方法2写入 PATH推荐echoexport PATH/usr/local/php/bin:/usr/local/php/sbin:$PATH/etc/profilesource/etc/profile# 验证php-vwhichphp# 应该输出 /usr/local/bin/php 或 /usr/local/php/bin/php--- 七、配置 PHP7.1创建 php.ini# PHP 源码包里有两个模板ls/opt/php-build/php-8.3.7/# php.ini-development → 开发环境模板显示错误# php.ini-production → 生产环境模板隐藏错误# 创建配置目录mkdir-p/usr/local/php/etc/php.d# 复制生产环境模板cp/opt/php-build/php-8.3.7/php.ini-production /usr/local/php/etc/php.ini# 编辑配置vim/usr/local/php/etc/php.ini;/usr/local/php/etc/php.ini[PHP];基础设置;内存限制根据服务器内存调整 memory_limit256M;最大执行时间秒 max_execution_time300;最大输入时间 max_input_time300;上传文件大小限制 upload_max_filesize100M post_max_size100M;最多上传几个文件 max_file_uploads20;错误处理生产环境;不在页面显示错误安全 display_errorsOff display_startup_errorsOff;记录错误到日志 log_errorsOn error_log/var/log/php/php_errors.log;错误级别记录所有错误 error_reportingE_ALL~E_DEPRECATED~E_STRICT;时区必须设置否则时间函数报警告date.timezoneAsia/Shanghai;字符编码default_charsetUTF-8mbstring.internal_encodingUTF-8 mbstring.languageChinese;Sessionsession.save_path/tmp/php_sessions session.gc_maxlifetime1440session.cookie_httponly1session.cookie_secure0;HTTPS 环境改为1;安全设置;禁用危险函数根据需要调整 disable_functionsexec,passthru,shell_exec,system,proc_open,popen,parse_ini_file,show_source;隐藏 PHP 版本信息 expose_phpOff;文件路径;扩展目录 extension_dir/usr/local/php/lib/php/extensions/no-debug-non-zts-20230831[opcache];OPcache 配置必须开启性能提升30~50%opcache.enable1opcache.enable_cli0;缓存内存大小MB opcache.memory_consumption256;字符串缓存MB opcache.interned_strings_buffer16;最多缓存多少个 PHP 文件 opcache.max_accelerated_files10000;生产环境关闭时间戳验证提升性能改代码后需手动清缓存 opcache.validate_timestamps0;重新验证间隔validate_timestamps1时有效 opcache.revalidate_freq60;JIT 编译PHP8.0ARM64 收益更大;tracing追踪模式最优选择 opcache.jittracing opcache.jit_buffer_size100M7.2创建 PHP-FPM 配置# 复制默认配置cp/usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.confcp/usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf# 编辑主配置vim/usr/local/php/etc/php-fpm.conf;/usr/local/php/etc/php-fpm.conf[global];PID 文件位置 pid/usr/local/php/var/run/php-fpm.pid;错误日志 error_log/usr/local/php/var/log/php-fpm.log;日志级别 log_levelwarning;紧急重启60秒内崩溃超过5次就重启 emergency_restart_threshold5emergency_restart_interval60s;子进程响应超时 process_control_timeout10s;后台运行 daemonizeyes;包含 pool 配置include/usr/local/php/etc/php-fpm.d/*.conf;/usr/local/php/etc/php-fpm.d/www.conf[www];运行用户需要和 Nginx 一致 userwww groupwww;通信方式;Unix Socket推荐比 TCP 快 listen/usr/local/php/var/run/php-fpm.sock listen.ownerwww listen.groupwww listen.mode0660;或者用 TCP跨机器部署时用这个;listen127.0.0.1:9000;等待队列长度 listen.backlog65535;进程管理;dynamic动态推荐 pmdynamic;进程数计算可用内存(MB)÷ 单进程内存(MB通常50~80MB);例如 8GB 给 PHP每进程 60MB8192÷60≈136取128pm.max_children50;启动时进程数CPU核数 ×2pm.start_servers8;最少空闲进程数CPU核数 pm.min_spare_servers4;最多空闲进程数CPU核数 ×2pm.max_spare_servers16;每个进程处理多少请求后重启防内存泄漏 pm.max_requests5000;空闲进程超时退出 pm.process_idle_timeout10s;超时保护;单请求最长执行时间 request_terminate_timeout30s;慢请求记录阈值 request_slowlog_timeout5s slowlog/usr/local/php/var/log/php-fpm-slow.log;访问日志access.log/usr/local/php/var/log/php-fpm-access.log access.format%R - %u %t\%m %r\%s %f %{mili}dms %{kilo}M;状态监控pm.status_path/fpm-status ping.path/fpm-ping ping.responsepong;PHP 运行参数覆盖php_admin_value[memory_limit]256M php_admin_value[error_log]/var/log/php/php-fpm-error.log php_admin_flag[log_errors]on php_admin_flag[display_errors]off --- 八、创建运行用户和目录# 创建 www 用户不允许登录的系统用户useradd-r-s/sbin/nologin-d/var/www www# 创建必要目录mkdir-p/var/www/html# 网站根目录mkdir-p/var/log/php# PHP 日志mkdir-p/tmp/php_sessions# Session 存储mkdir-p/usr/local/php/var/run# PID 文件mkdir-p/usr/local/php/var/log# PHP-FPM 日志# 设置权限chown-Rwww:www /var/www/htmlchown-Rwww:www /var/log/phpchown-Rwww:www /tmp/php_sessionschown-Rwww:www /usr/local/php/var/# 验证用户创建成功idwww --- 九、配置 PHP-FPM 系统服务# 创建 systemd 服务文件cat/etc/systemd/system/php-fpm.serviceEOF[Unit]DescriptionPHP FastCGI Process ManagerDocumentationman:php-fpm(8)Afternetwork.target[Service]Typenotify# PID 文件路径PIDFile/usr/local/php/var/run/php-fpm.pid# 启动命令--nodaemonize 让 systemd 管理进程ExecStart/usr/local/php/sbin/php-fpm