ubuntu php配置需要注意啥

在 Ubuntu 上配置 PHP（通常是配合 Nginx 或 Apache 使用），有几个容易踩坑但很关键的点。下面按「安装 → 配置 → 安全 → 排错」给你梳理一下。

一、安装相关

1. 选对 PHP 版本

Ubuntu 默认源里的 PHP 版本可能较旧：

php -v

如果需要新版本（如 8.2 / 8.3）：

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3 php8.3-fpm

✅ 推荐：PHP-FPM（性能更好，Nginx 必用）

二、Web 服务器配合（重点）

2. Nginx + PHP-FPM（最常见）

确保安装：

sudo apt install php8.3-fpm nginx

Nginx 配置示例：

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

⚠️ 常见错误：

• fastcgi_pass 路径写错
• 没 include fastcgi_params
• .php 文件被直接下载

3. Apache 用户注意

如果用 Apache：

sudo apt install libapache2-mod-php8.3
sudo a2enmod php8.3

三、PHP 本身配置（php.ini）

配置文件位置：

/etc/php/8.3/fpm/php.ini      # FPM
/etc/php/8.3/cli/php.ini      # 命令行

4. 必须检查的项

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 120
cgi.fix_pathinfo=0   # 安全重要

改完重启：

sudo systemctl restart php8.3-fpm

四、权限问题（高频坑）

5. 用户和目录权限

• Nginx/Apache 用户通常是 www-data
• PHP 写日志/缓存目录必须可写

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

⚠️ 不要用 777

五、安全注意

6. 禁用危险函数（服务器环境）

disable_functions = exec,passthru,shell_exec,system,proc_open

7. 关闭错误显示（生产）

display_errors = Off
log_errors = On

六、常见排错

8. 页面空白 / 500

检查：

sudo tail -f /var/log/php8.3-fpm.log
sudo tail -f /var/log/nginx/error.log

9. PHP 不执行

• 文件后缀是 .php
• Nginx 没匹配 location ~ \.php$
• FPM 没启动

systemctl status php8.3-fpm

七、扩展安装

sudo apt install php8.3-mysql php8.3-curl php8.3-mbstring php8.3-gd

装完重启 FPM。

如果你告诉我：

• Ubuntu 版本
• Nginx 还是 Apache
• PHP 用途（Laravel / WordPress / 原生）

我可以直接给你一套可用配置模板。