Debian下PHP如何配置

在 Debian 下配置 PHP，通常分为 安装 PHP、配置 PHP 本身、与 Web 服务器（Apache/Nginx）配合、以及常见调优 几个部分。下面按使用场景说明。

一、安装 PHP（Debian）

1. 更新系统

sudo apt update
sudo apt upgrade

2. 安装 PHP（以 PHP 8.2 为例）

sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip

查看版本：

php -v

二、PHP 主配置文件位置

类型	路径
CLI	`/etc/php/8.2/cli/php.ini`
FPM	`/etc/php/8.2/fpm/php.ini`
Apache	`/etc/php/8.2/apache2/php.ini`

修改后需重启对应服务

三、与 Web 服务器配置

✅ Apache + PHP（mod_php）

sudo apt install apache2 libapache2-mod-php
sudo systemctl restart apache2

测试：

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

访问：http://服务器IP/info.php

✅ Nginx + PHP（PHP-FPM，推荐）

1. 安装 Nginx

sudo apt install nginx

2. 配置站点

编辑 /etc/nginx/sites-available/default：

server {
    listen 80;
    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

3. 重启服务

sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm

四、常见 php.ini 配置

编辑：

sudo nano /etc/php/8.2/fpm/php.ini

推荐修改项：

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 120
date.timezone = Asia/Shanghai

应用：

sudo systemctl restart php8.2-fpm

五、PHP-FPM 进程配置（性能）

文件：

/etc/php/8.2/fpm/pool.d/www.conf

常用：

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20

六、常见问题排查

PHP 不解析（Nginx）

确认 php-fpm 已运行
fastcgi_pass sock 路径正确

权限问题

sudo chown -R www-data:www-data /var/www/html

查看错误日志

tail -f /var/log/php8.2-fpm.log
tail -f /var/log/nginx/error.log

七、示例：最小可用环境

apt install nginx php-fpm php-mysql

如果你告诉我：

用的是 Apache 还是 Nginx
PHP 版本
具体用途（WordPress / Laravel / API）

我可以给你 精确配置文件示例。