Debian PHP 服务部署指南

一 环境准备与版本确认

部署的第一步，永远是打好基础。在安装任何软件之前，先确保你的系统是最新的。这能有效避免后续因依赖版本问题带来的麻烦。

• 更新索引并升级系统：
  • 执行命令：sudo apt update && sudo apt upgrade -y。这个过程可能需要一点时间，耐心等待即可。
• 确认可用 PHP 版本与模块：
  • 先看看仓库里有哪些PHP-FPM版本可用：apt search php | grep -E ‘^php[0-9.]±fpm’。
  • 根据你的项目需求，常见的扩展如php-curl、php-gd、php-mbstring、php-xml、php-zip、php-mysql等，可以按需安装。
• 注意： 不同 Debian 版本（如 Bullseye 与 Bookworm）默认的 PHP 主次版本可能不同。这一点至关重要，因为后续的配置路径与 socket 名称（例如 php7.4-fpm 或 php8.2-fpm）必须与实际安装的版本严格对应。

二 方案一 Apache + mod_php（快速上手）

如果你追求快速搭建一个可用的环境，或者对 Apache 更熟悉，这个方案无疑是最直接的。它省去了额外的进程管理配置，一切由 Apache 自己搞定。

• 安装组件：
  • 一条命令搞定基础环境：sudo apt install apache2 libapache2-mod-php php php-mysql。
• 常用优化与模块：
  • 启用 URL 重写模块，这对许多现代框架是必需的：sudo a2enmod rewrite。
  • 其他模块如 ssl（HTTPS）、headers（自定义响应头）等，可以根据需要启用。
• 重启生效：
  • 配置改动后，别忘了让服务重启：sudo systemctl restart apache2。
• 验证：
  • 创建一个测试文件：echo “” | sudo tee /var/www/html/info.php。
  • 打开浏览器，访问 https://你的服务器IP/info.php。如果能看到详尽的 PHP 信息页面，恭喜你，环境已经跑起来了。

三 方案二 Nginx + PHP-FPM（推荐生产）

对于生产环境，Nginx 搭配 PHP-FPM 是更主流、性能也更优的选择。Nginx 负责高效处理静态请求和反向袋里，PHP-FPM 则专职处理 PHP 动态脚本，分工明确。

• 安装组件：
  • 安装核心软件包：sudo apt install nginx php-fpm php-mysql。
• 配置 PHP-FPM（以实际版本为例，如 8.2）：
  • 编辑池配置： sudo nano /etc/php/8.2/fpm/pool.d/www.conf
    • 确认或设置监听方式：listen = /run/php/php8.2-fpm.sock（Unix Socket，性能更好）。
    • 确保运行用户和组是 Web 服务器用户：user = www-data，group = www-data。
    • 如果想使用 TCP 端口方式，可改为：listen = 127.0.0.1:9000（记得 Nginx 配置也要同步修改）。
  • 启动与开机自启：
    • 启动服务：sudo systemctl start php8.2-fpm
    • 设置开机自启：sudo systemctl enable php8.2-fpm
• 配置 Nginx 站点（/etc/nginx/sites-a vailable/default）：
  • 示例配置：

    server {
        listen 80 default_server;
        root /var/www/html;
        index index.php index.html;
        server_name _;
    
        location / {
            try_files $uri $uri/ =404;
        }
    
        location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/run/php/php8.2-fpm.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    
        location ~ /\.ht {
            deny all;
        }
    }

  • 语法检查与生效：
    • 在重启前务必检查配置语法：sudo nginx -t。确认无误后，再重启服务：sudo systemctl restart nginx。
• 验证：
  • 同样创建一个 PHP 信息文件：echo “” | sudo tee /var/www/html/info.php。
  • 浏览器访问 https://服务器IP/info.php，验证 Nginx 能否正确将 PHP 请求交给 FPM 处理。

四 防火墙与 HTTPS

服务上线前，安全是最后一道，也是必不可少的一道工序。

• 防火墙放行（示例 UFW）：
  • 允许 HTTP 和 HTTPS 流量：sudo ufw allow ‘Nginx Full’ 或 sudo ufw allow 80,443/tcp。
  • 启用防火墙：sudo ufw enable。
• 申请并配置 Let’s Encrypt 证书（certbot）：
  • 安装 Certbot 工具：sudo apt install certbot python3-certbot-nginx。
  • 一键获取并配置证书（将 your_domain 替换为你的真实域名）：sudo certbot --nginx -d your_domain。
  • 跟着提示操作，它会自动为你配置好 HTTPS 并设置自动续期，非常省心。

五 常见问题与优化

部署完成只是开始，让服务稳定高效地运行才是关键。这里有几个常见的“坑”和优化方向。

• 502 Bad Gateway / No input file specified：
  • 首要检查点： 核对 Nginx 配置中的 fastcgi_pass 指令（例如 unix:/run/php/php8.2-fpm.sock）是否与 PHP-FPM 配置文件中的 listen 设置完全一致（无论是 Socket 路径还是 TCP 端口）。
  • 服务状态： 确认 PHP-FPM 进程是否在运行：systemctl status php*-fpm。如果使用 Socket，检查文件是否存在：ls -l /run/php/。
  • 关键参数： 确保 Nginx 的 PHP location 块里包含了这一行：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，它告诉 FPM 脚本的具体位置。
• 权限与目录：
  • Web 根目录（如 /var/www/html）的所有者和组建议设置为 www-data:www-data，文件和目录权限通常设为 644 和 755。如果系统启用了 SELinux 或 AppArmor，可能需要额外配置策略以允许 Nginx/PHP 访问相关目录。
• 性能与运维：
  • 启用 OPcache（生产环境强烈推荐）： 在对应的 php.ini 文件中设置 opcache.enable=1，并根据服务器内存调整 opcache.memory_consumption、opcache.interned_strings_buffer、opcache.max_accelerated_files 等参数，能极大提升 PHP 执行效率。
  • FPM 进程管理： 在 FPM 池配置文件（www.conf）中，根据服务器内存和负载调整 pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers。对于排查性能问题，可以开启慢日志（slowlog）并设置 request_slowlog_timeout。
  • 日志排查： 出问题时，日志是你的第一手资料。重点关注 Nginx 错误日志（/var/log/nginx/error.log）和 PHP-FPM 日志（/var/log/php*-fpm.log 或在池配置中指定的日志文件）。