Debian系统搭建PHP网站运行环境分步教程-php教程-PHP中文网

debian系统php网站跑不起来，90%是web服务器与php-fpm通信链路或权限问题：先执行php -v和php -m验证php cli是否就绪；apache需装libapache2-mod-php8.1并a2enmod启用；nginx连php-fpm需确保socket路径、user/group、listen.owner均为www-data且重启php8.1-fpm服务。

debian系统搭建php网站运行环境分步教程

Debian系统上PHP网站跑不起来，90%不是PHP没装好，而是Web服务器没连上PHP-FPM或权限没对齐——尤其是php8.1-fpm和nginx或apache2之间那条通信链路。

怎么确认PHP本身装对了

别急着配Web服务器，先验证PHP运行时是否就绪。很多问题其实卡在第一步。

执行php -v，必须看到类似PHP 8.1.x的输出；如果报command not found，说明php-cli根本没装，不是版本问题，是包名漏了
扩展不能靠猜：用php -m | grep -E "(mysql|curl|gd|mbstring)"逐个确认，php-mysql和php-mysqli是两个包，WordPress要前者，Laravel常要后者
如果php --ini显示配置路径是/etc/php/8.1/cli/php.ini，注意：CLI配置和FPM配置是分开的，Web请求走的是/etc/php/8.1/fpm/php.ini

Apache下为什么phpinfo()页面空白或下载PHP文件

这是Apache没加载PHP模块，或模块版本错配的典型表现。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

必须装libapache2-mod-php8.1（不是php8.1本身），然后运行a2enmod php8.1启用模块
重启服务必须用sudo systemctl restart apache2，只reload不够，mod_php需要完整重载
检查/etc/apache2/mods-enabled/下是否有php8.1.load和php8.1.conf两个软链，缺一个就失效
若用php8.1-fpm而非mod_php，Apache需额外装libapache2-mod-proxy-fcgi并配置ProxyPassMatch，不推荐新手走这条路

Nginx连不上php8.1-fpm：Permission denied或502

connect() to unix:/run/php/php8.1-fpm.sock failed (13: Permission denied)——这不是路径写错，是用户组权限没对齐。

查ps aux | grep php-fpm，确认master进程的user/group是www-data；再看/run/php/php8.1-fpm.sock的属主：ls -l /run/php/，必须是www-data:www-data
编辑/etc/php/8.1/fpm/pool.d/www.conf，确保这三行一致：user = www-data、group = www-data、listen.owner = www-data
Nginx配置里fastcgi_pass必须严格匹配socket路径，比如unix:/run/php/php8.1-fpm.sock，少个/或写成php8.1-fpm.socket都会失败
如果改过listen为127.0.0.1:9000，记得把listen.owner这类权限项全注释掉，TCP模式不认这些

测试页能打开但数据库连不上

常见于MySQL/MariaDB已装，但PHP没连对驱动或权限没放行。

php -m | grep mysql应同时输出mysqlnd和pdo_mysql；如果只有mysqli，PDO应用（如Laravel）会报Class 'PDO' not found
Debian 11+默认装的是MariaDB，root用户默认禁用密码登录，得用sudo mysql进库，再执行CREATE USER 'webuser'@'localhost' IDENTIFIED BY 'pass'; GRANT ALL ON *.* TO 'webuser'@'localhost';
PHP连接字符串用mysql:host=localhost;dbname=test时，localhost会走socket，换成127.0.0.1强制走TCP，避开socket权限问题
/etc/php/8.1/fpm/php.ini里extension=mysqli和extension=pdo_mysql前面不能有分号，且顺序无关