configure报“xxx not found”错误是因缺开发头文件而非运行库，Ubuntu/Debian需装libxxx-dev、RHEL/CentOS需装libxxx-devel，且必须安装pkg-config并验证其探测能力。
configure阶段报“not found”错误怎么定位
源码编译PHP时，./configure 报 xxx not found（比如 libxml2 not found、jpeglib.h not found）不是缺软件包本身，而是缺开发头文件。Ubuntu/Debian叫 libxxx-dev，CentOS/RHEL叫 libxxx-devel，装错就白忙活。
- 先查缺失项具体是什么：看 configure 输出最后一行或 grep “not found” 的上下文，确认是哪个库
- Ubuntu 示例：
sudo apt install libxml2-dev libjpeg-dev libpng-dev libfreetype6-dev libonig-dev libsqlite3-dev zlib1g-dev - CentOS/RHEL 示例：
sudo yum install libxml2-devel libjpeg-devel libpng-devel freetype-devel oniguruma-devel sqlite-devel zlib-devel（RHEL 8+ 用dnf） - 别漏
pkg-config——很多 configure 依赖它探测库路径，Ubuntu 装pkg-config，CentOS 装pkgconfig
–prefix 和 –with-config-file-path 必须配对设置
不设 --prefix 或设错路径，会导致 php -v 找不到二进制，或者 php --ini 显示配置路径混乱；不设 --with-config-file-path，PHP 启动时压根不加载 php.ini，所有扩展、内存限制、上传大小等全按默认值走，线上必出问题。
-
--prefix=/usr/local/php-8.2是安装根目录，后续php、php-fpm都在/usr/local/php-8.2/bin/下 -
--with-config-file-path=/usr/local/php-8.2/etc表示 PHP 运行时只认这个路径下的php.ini - 复制模板后必须放对位置：
cp php.ini-production /usr/local/php-8.2/etc/php.ini - 验证是否生效：
/usr/local/php-8.2/bin/php --ini输出应显示Loaded Configuration File => /usr/local/php-8.2/etc/php.ini
PHP-FPM 启动失败常见三类权限陷阱
启动 php-fpm 时卡住、无日志、状态显示 inactive (dead)，90% 是权限没对齐。Unix socket 文件（如 /run/php/php-fpm.sock）的属主、属组、目录可写性，三者缺一不可。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 确保
www.conf中user = www-data（Ubuntu/Debian）或user = nginx（RHEL/CentOS），且listen.owner和listen.group与 Web 服务器运行用户一致 -
/run/php/目录必须存在且由 root 创建，权限为drwxr-xr-x，属主属组为root:root；FPM 启动后会自动 chown socket 文件 - 如果用 TCP 模式（
listen = 127.0.0.1:9000），要检查netstat -tlnp | grep :9000是否被其他进程占用，或防火墙是否拦截本地 loopback - 启动命令必须带完整路径：
/usr/local/php-8.2/sbin/php-fpm -t测试配置，/usr/local/php-8.2/sbin/php-fpm启动
Nginx 转发 .php 请求时 fastcgi_pass 写法易错
配置 Nginx 让它把 .php 请求交给 PHP-FPM 处理，关键在 fastcgi_pass 值——它必须和 PHP-FPM 的 listen 完全一致，否则 502 Bad Gateway 是必然结果。
立即学习“PHP免费学习笔记（深入）”；
- 若 PHP-FPM
listen = /run/php/php-fpm.sock，Nginx 配置必须写：fastcgi_pass unix:/run/php/php-fpm.sock;（注意开头unix:和结尾分号） - 若 PHP-FPM
listen = 127.0.0.1:9000，Nginx 写：fastcgi_pass 127.0.0.1:9000; -
fastcgi_param SCRIPT_FILENAME必须指向真实磁盘路径，例如fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，不能写成/var/www/html/$fastcgi_script_name这种硬编码 - 改完 Nginx 配置务必
sudo nginx -t && sudo systemctl reload nginx，别只reload不测试
php.ini 里 date.timezone 和 error_reporting 的显式设置——它们不会导致服务起不来，但会让日志空、时区错、错误不报，排查时绕一大圈。 
