Ubuntu/Debian中直接apt install php失败是因默认源无php元包，需先sudo apt update，再安装具体版本如php8.2-cli及扩展，并启用Apache的php8.2模块、配置SetHandler，同时校准MySQL socket路径和www-data权限。
PHP 安装失败：apt install php 没反应或报错“无法定位软件包”
Ubuntu/Debian 默认源里，php 包名不直接可用，尤其新版本系统（如 Ubuntu 22.04+）默认不带 PHP 元包。直接 apt install php 会失败，不是你网络或命令错了，是源没更新或包名变了。
- 先运行
sudo apt update，确保索引最新 - 查可用版本：
apt list -a php（注意末尾带空格），常见结果是php8.1、php8.2这类具体版本包 - 装基础运行环境：
sudo apt install php8.2-cli php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring——别只装php8.2，它只是元包，实际扩展得手动列 - 验证：
php -v和php -m | grep mysql看是否加载了关键扩展
Apache 不解析 .php 文件，浏览器直接下载或显示源码
这是 LAMP 搭建中最常卡住的点：PHP 装了，Apache 也跑了，但 index.php 就是不执行。核心原因是 Apache 没加载 libphp 模块，也没配置好 AddType 或 SetHandler。
- 确认模块已启用：
a2enmod php8.2（版本号必须和你装的 PHP 一致） - 检查配置文件是否含
LoadModule php_module /usr/lib/apache2/modules/libphp8.2.so——新版 Ubuntu 通常自动加，但如果你改过/etc/apache2/mods-available/php8.2.load，得确认路径存在 - 在站点配置（如
/etc/apache2/sites-enabled/000-default.conf）的<Directory>块里，确保有：<FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch> - 重启服务：
sudo systemctl restart apache2，别只 reload
MySQL 连接不上：PHP 报错 mysqli_connect(): (HY000/2002): No such file or directory
这个错误不是密码错，也不是用户没权限，而是 PHP 找不到 MySQL 的 socket 文件。常见于 MySQL 改过数据目录，或 PHP 用的是默认 socket 路径（/var/run/mysqld/mysqld.sock），而 MySQL 实际监听在 /tmp/mysql.sock 或别的位置。
- 查 MySQL 实际 socket：
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 查 PHP 配置的 socket：
php -i | grep "mysql.default_socket"，如果为空，说明 PHP 用的是编译时默认值 - 统一方案：编辑
/etc/php/8.2/apache2/php.ini，设mysqli.default_socket = /var/run/mysqld/mysqld.sock（填你上一步查到的真实路径） - 或者更稳妥：在
mysqli_connect()里显式传 socket，比如：mysqli_connect('localhost', 'user', 'pass', 'db', 3306, '/var/run/mysqld/mysqld.sock')
权限与路径陷阱：Web 目录下写日志、上传文件总失败
PHP 进程由 www-data 用户运行，但它对 /var/www/html 下的子目录未必有写权限，尤其你用 cp 或 git clone 放进去的代码，属主还是你自己的用户。
立即学习“PHP免费学习笔记（深入）”；
- 别用
chmod 777——临时能用，但等于敞开大门 - 正确做法：
sudo chown -R $USER:www-data /var/www/html/myapp，再sudo chmod -R 755 /var/www/html/myapp，上传目录单独加写权限：sudo chmod 775 /var/www/html/myapp/uploads - PHP 里用相对路径（如
__DIR__ . '/logs/error.log'）比硬写/var/www/...更安全，避免因 DocumentRoot 变动出错 - SELinux？Ubuntu 默认没开；CentOS/RHEL 上得额外处理上下文，但那是另一套逻辑了
最麻烦的从来不是装几个包，而是每个组件默认用的路径、用户、socket、模块名都差那么一点——对不上就白忙半小时。
