温馨提示×

PHP配置Ubuntu怎么做

小樊
45
2026-08-12 13:28:15
栏目: 编程语言

下面给你一份在 Ubuntu 上配置 PHP 的完整常见做法,从安装到常用配置,适用于 Ubuntu 20.04 / 22.04 / 24.04


一、安装 PHP(最常见方式)

1️⃣ 更新软件源

sudo apt update
sudo apt upgrade -y

2️⃣ 安装 PHP(默认版本)

sudo apt install php -y

查看版本:

php -v

3️⃣ 安装常用 PHP 扩展(强烈推荐)

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

如果是 Laravel / ThinkPHP / WordPress,基本够用。


二、PHP 与 Web 服务器配合使用

✅ 情况一:Nginx + PHP(推荐)

1️⃣ 安装 Nginx 和 PHP-FPM

sudo apt install nginx php-fpm -y

2️⃣ 查看 PHP-FPM sock 路径

php -v
# 例如:PHP 8.1
ls /run/php/
# php8.1-fpm.sock

3️⃣ 配置 Nginx

编辑站点配置:

sudo nano /etc/nginx/sites-available/default

示例配置:

server {
    listen 80;
    server_name localhost;

    root /var/www/html;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

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

⚠️ 注意:PHP 版本要对应

4️⃣ 重启服务

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

✅ 情况二:Apache + PHP

1️⃣ 安装 Apache 和 PHP

sudo apt install apache2 php libapache2-mod-php -y

2️⃣ 重启 Apache

sudo systemctl restart apache2

测试:

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

浏览器访问:

http://服务器IP/info.php

三、PHP 配置文件位置

主配置文件

php -i | grep "Loaded Configuration File"

常见路径:

/etc/php/8.1/cli/php.ini     # 命令行
/etc/php/8.1/fpm/php.ini     # PHP-FPM

四、常用 PHP 配置修改

编辑:

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

常见修改项

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

修改后重启:

sudo systemctl restart php8.1-fpm

五、安装指定 PHP 版本(如 PHP 8.2)

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

sudo apt install php8.2 php8.2-fpm php8.2-mysql -y

六、验证 PHP 是否正常工作

php -r "echo 'PHP OK';"

或创建测试文件:

sudo nano /var/www/html/test.php
<?php
phpinfo();

七、常见问题

❌ 502 Bad Gateway

  • PHP-FPM 没启动
  • Nginx 中 sock 路径错误
sudo systemctl status php8.1-fpm

❌ PHP 文件被下载而不是执行

  • Nginx 没配置 location ~ \.php$
  • Apache 没加载 libapache2-mod-php

八、我可以继续帮你

你可以直接告诉我:

  • ✅ Ubuntu 版本
  • ✅ 用 Nginx 还是 Apache
  • ✅ 是 Laravel / ThinkPHP / WordPress / 原生 PHP
  • ✅ 是否用于生产环境

我可以给你完全定制化的 PHP 配置方案

0