根本原因是PATH未包含PHP二进制路径，需将/opt/php/bin加入~/.bashrc或~/.zshrc的PATH；mysqli未显示因编译禁用或php.ini中被注释；opcache崩溃源于内存配置冲突，须调低opcache.memory_consumption并关闭opcache.fast_shutdown；gd扩展报错因缺少libpng-dev等开发头文件。
PHP安装后php -v报错“command not found”
根本原因是PATH未包含PHP二进制路径，尤其在源码编译或非标准路径安装时常见。比如用./configure --prefix=/opt/php编译后，php实际在/opt/php/bin/php，但系统默认不搜索该目录。
解决方法是将路径加入用户环境变量：
- 编辑
~/.bashrc或~/.zshrc，追加export PATH="/opt/php/bin:$PATH" - 执行
source ~/.bashrc（或对应shell配置文件）立即生效 - 验证：运行
which php应输出/opt/php/bin/php，再试php -v
注意：不要直接修改/etc/environment或全局/etc/profile，除非明确要对所有用户生效；多版本共存时，更推荐用update-alternatives管理。
安装mysqli扩展但php -m | grep mysqli无输出
常见于PHP 7.4+默认不启用MySQLi（尽管它已内置），或使用php-fpm时加载了不同php.ini文件。
立即学习“PHP免费学习笔记（深入）”；
分两步排查：
- 确认扩展是否已编译进PHP：运行
php -i | grep "Configure Command"，若输出中含--without-mysqli，说明编译时被禁用，需重新编译并加上--with-mysqli=mysqlnd - 若已内置，检查
php.ini是否禁用了它：运行php --ini看加载的配置路径，打开对应php.ini，确保没有;extension=mysqli（分号表示注释）；如存在，删掉分号，保存后重启php-fpm或Web服务器 - 特别注意：
cli和fpm可能使用不同php.ini，分别用php -i和php-fpm -i确认
启用opcache后页面偶尔502或空白，php-fpm日志报zend_mm_heap corrupted
这是opcache内存分配与PHP内存限制冲突的典型表现，尤其在低配VPS或启用了apcu等其他共享内存扩展时容易触发。
关键调整项（在php.ini中）：
-
opcache.memory_consumption=128（建议64–192之间，勿设过高，如512易出错） -
opcache.interned_strings_buffer=16（默认8，升到16可缓解字符串哈希冲突） -
opcache.max_accelerated_files=4000（根据项目文件数设，过大会占内存且降低命中率） - 必须关闭
opcache.fast_shutdown=1（PHP 7.4+已废弃，设为0；旧版设为1反而易引发崩溃） - 如果同时用
apcu，确保apc.enable_cli=0且不与opcache争抢共享内存段
改完后务必重启php-fpm，并用php -r "print_r(opcache_get_status());"验证状态是否正常。
安装gd扩展时报configure: error: png.h not found或jpeglib.h not found
这不是PHP的问题，而是缺少图像库的开发头文件。各发行版包名不同，仅装libpng或libjpeg运行时库不够，必须装-dev（Debian/Ubuntu）或-devel（RHEL/CentOS）后缀的包。
对应命令：
- Ubuntu/Debian：
sudo apt install libpng-dev libjpeg-dev libfreetype6-dev - CentOS/RHEL 7：
sudo yum install libpng-devel libjpeg-devel freetype-devel - CentOS/RHEL 8+：
sudo dnf install libpng-devel libjpeg-devel freetype-devel
装完再进PHP源码目录执行./configure --with-gd --with-jpeg-dir=/usr --with-png-dir=/usr --with-freetype-dir=/usr（路径按实际调整，多数情况默认即可）。若系统用的是libjpeg-turbo，则--with-jpeg-dir可能需指向/usr/lib64或/usr/include，可用find /usr -name "jpeglib.h"定位。
扩展启用后，用php -r "var_dump(gd_info());"确认jpg、png、FreeType三项均为true才算真正就绪。
