如何在Linux系统上搭建PHP环境？一步步教你完成PHP开发环境配置-php教程-PHP中文网

答案：在Ubuntu上搭建PHP开发环境需安装Nginx、PHP-FPM和MariaDB，配置Nginx与PHP-FPM协同工作，并通过info.php测试环境。

如何在linux系统上搭建php环境？一步步教你完成php开发环境配置

在Linux系统上搭建PHP开发环境，说白了，就是要把Web服务器（比如Nginx或Apache）、PHP解释器（通常是PHP-FPM）以及一个数据库（如MariaDB或MySQL）这几个核心组件安装好，并让他们能协同工作。这听起来可能有点像搭积木，但每个积木块都有它的脾气和连接方式，需要我们细心去配置。一旦成功，你就能在这片个人搭建的“乐土”上跑起你的PHP应用了。

解决方案

搭建PHP环境，我个人偏好Nginx搭配PHP-FPM，因为它在处理高并发请求时表现出色，而且资源占用相对较少。这里以Ubuntu系统为例，一步步来：

1. 更新系统与安装基础组件

这总是一个好的开始，确保你的系统是最新状态，能避免一些不必要的依赖问题。

立即学习“PHP免费学习笔记（深入）”；

sudo apt update
sudo apt upgrade -y

登录后复制

2. 安装Nginx Web服务器

Nginx将作为你的Web服务器，负责接收用户的请求并将其转发给PHP处理。

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx

登录后复制

安装完成后，在浏览器中访问你的服务器IP地址，应该能看到Nginx的欢迎页面。

3. 安装PHP及PHP-FPM

PHP-FPM（FastCGI Process Manager）是PHP的一个进程管理器，它能让PHP作为一个独立的进程运行，并通过FastCGI协议与Nginx通信。这里我们会安装一些常用的PHP扩展。

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

登录后复制

安装完成后，PHP-FPM服务会自动启动并设置为开机自启。你可以检查一下它的状态：

sudo systemctl status php*-fpm

登录后复制

（注意这里的

php*-fpm

登录后复制

，它会匹配你安装的PHP版本，比如

php8.1-fpm

登录后复制

）

4. 配置Nginx与PHP-FPM协作

这是关键一步，让Nginx知道如何把

.php

登录后复制

文件的请求交给PHP-FPM处理。我们需要编辑Nginx的站点配置文件。通常，默认的配置文件在

/etc/nginx/sites-available/default

登录后复制

。

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

登录后复制

找到类似这样的代码块（通常是被注释掉的）：

# Add index.php to the list if you are using PHP
# index index.html index.htm index.nginx-debian.html;

# pass PHP scripts to FastCGI server
#
#location ~ \.php$ {
#       include snippets/fastcgi-php.conf;
#       fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 这里的版本号请根据实际安装的PHP版本调整
#}

登录后复制

你需要做几件事：

在
```
index
```
登录后复制
行中添加
```
index.php
```
登录后复制
，让Nginx在找不到
```
index.html
```
登录后复制
时尝试加载
```
index.php
```
登录后复制
。
取消注释
```
location ~ \.php$
```
登录后复制
整个代码块。
确保
```
fastcgi_pass
```
登录后复制
指向的是你实际安装的PHP-FPM的socket文件。例如，如果是PHP 8.1，那就是
```
unix:/var/run/php/php8.1-fpm.sock;
```
登录后复制
。如果你不确定，可以查看
```
/var/run/php/
```
登录后复制
目录下的文件。

修改后的相关部分可能看起来像这样：

root /var/www/html; # 这是你的网站根目录，可以根据需要修改

# Add index.php to the list if you are using PHP
index index.php index.html index.htm index.nginx-debian.html;

server_name your_domain_or_ip; # 替换成你的域名或IP地址

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

# pass PHP scripts to FastCGI server
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 请务必确认这里的PHP版本号
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
#       deny all;
#}

登录后复制

保存并关闭文件（

Ctrl+O

登录后复制

，

Enter

登录后复制

，

Ctrl+X

登录后复制

）。检查Nginx配置文件的语法是否有误：

sudo nginx -t

登录后复制

如果显示

syntax is ok

登录后复制

和

test is successful

登录后复制

，就可以重启Nginx了：

sudo systemctl restart nginx

登录后复制

5. 安装数据库（MariaDB）

对于PHP应用，数据库几乎是不可或缺的。MariaDB是MySQL的一个强大替代品，性能优秀且兼容性好。

sudo apt install mariadb-server -y
sudo systemctl start mariadb
sudo systemctl enable mariadb

登录后复制

安装后，强烈建议运行安全脚本来加固你的数据库：

sudo mysql_secure_installation

登录后复制

这个脚本会引导你设置root密码、移除匿名用户、禁止root远程登录、移除测试数据库等。

码上飞

码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

6. 测试PHP环境

现在，我们创建一个简单的PHP文件来验证一切是否正常工作。

sudo nano /var/www/html/info.php

登录后复制

在文件中添加以下内容：

<?php
phpinfo();
?>

登录后复制

保存并关闭文件。在浏览器中访问

http://你的服务器IP地址/info.php

登录后复制

。如果你能看到一个详细的PHP信息页面，恭喜你，你的PHP开发环境已经成功搭建！出于安全考虑，在测试完成后，记得删除这个

info.php

登录后复制

文件：

sudo rm /var/www/html/info.php

登录后复制

为什么选择Nginx而不是Apache？它们各自的优势在哪里？

选择Nginx还是Apache，这真的是一个老生常谈的话题，但它背后蕴含着对Web服务架构的深刻理解。在我看来，这没有绝对的对错，更多是基于项目需求、团队经验和个人偏好的一种权衡。

Nginx的优势：

我个人更倾向于Nginx，尤其是在处理现代Web应用时。Nginx采用了事件驱动（Event-driven）的架构，这意味着它能够以非阻塞的方式处理大量并发连接。当一个请求进来时，Nginx不会为每个请求都创建一个新的进程或线程，而是通过一个或几个工作进程来高效地管理所有连接。这种模型使得Nginx在作为静态文件服务器或反向代理时表现极其出色，资源消耗极低，响应速度飞快。对于PHP应用，Nginx通常与PHP-FPM结合使用，Nginx负责处理HTTP请求和静态资源，而PHP-FPM则专门负责解析PHP代码。这种分离使得两者各司其职，效率更高。我曾经遇到过一个高并发的API服务，从Apache切换到Nginx后，服务器的CPU和内存占用明显下降，而吞吐量却大幅提升，那种优化效果是实实在在能感受到的。

Apache的优势：

Apache，作为Web服务器的“老大哥”，其优势在于其成熟度和模块化。它采用进程/线程模型（Process/Thread-driven），每个请求通常会由一个新的进程或线程来处理。虽然这在处理高并发时可能会消耗更多资源，但它带来了无与伦比的灵活性。Apache拥有庞大的模块生态系统（如

mod_php

登录后复制

可以直接在Apache内部处理PHP，

mod_rewrite

登录后复制

提供强大的URL重写功能，以及

.htaccess

登录后复制

文件可以在不修改主配置文件的情况下进行目录级别的配置），这对于许多共享主机环境和那些需要快速迭代、频繁调整配置的场景来说，简直是福音。对于初学者而言，Apache的配置往往更为直观，特别是

.htaccess

登录后复制

这种“所见即所得”的配置方式，可以省去不少与系统管理员沟通的麻烦。我刚开始学习PHP的时候，就是用Apache的

mod_php

登录后复制

，那种开箱即用的便利性确实让人印象深刻。

总的来说，如果你追求极致的性能、高并发处理能力，并且乐于接受Nginx相对“简洁”的配置哲学，那么Nginx是绝佳选择。而如果你更看重灵活性、成熟的生态系统，或者你的应用依赖于

.htaccess

登录后复制

等特性，那么Apache依然是值得信赖的伙伴。

PHP版本选择有何讲究？如何避免常见的兼容性问题？

PHP版本的选择，这可不是小事，它直接关系到你的应用性能、安全性，以及最重要的——兼容性。我见过太多因为PHP版本升级导致网站“罢工”的案例，那种从天堂到地狱的感觉，真是刻骨铭心。

PHP版本选择的讲究：

最新稳定版优先： 通常情况下，我建议尽可能使用PHP的最新稳定版本（比如撰写本文时的PHP 8.x系列）。新版本通常带来了显著的性能提升（通过JIT编译器等技术）、新特性（如更严格的类型声明、属性提升等）以及最重要的安全修复。这意味着你的应用会运行得更快，代码可以更现代化，并且能抵御已知的安全漏洞。
LTS（长期支持）版本： 对于生产环境，如果你的应用对稳定性有极高的要求，或者你希望获得更长的安全补丁支持，那么选择一个LTS版本也是一个明智之举。LTS版本虽然不一定是最新的，但它经过了更长时间的验证，并且官方会提供更长时间的维护。
应用兼容性： 这是最最关键的一点。在选择PHP版本之前，务必检查你的应用（包括使用的框架、CMS如WordPress/Laravel/Symfony、以及所有的第三方库和插件）所要求的最低和推荐PHP版本。盲目升级到最新版，很可能导致某些老旧的库或自定义代码因为使用了被废弃的函数、语法或依赖于旧的行为而崩溃。

如何避免常见的兼容性问题：

阅读官方升级指南： PHP官方在每个大版本升级时，都会发布详细的“迁移指南”（Migration Guide）。这玩意儿虽然枯燥，但却是避免踩坑的“圣经”。它会列出所有被废弃、修改或新增的特性，以及可能导致不兼容的代码变动。
使用Composer进行依赖管理： 如果你的项目使用Composer，那么在升级PHP版本前，可以尝试运行
```
composer update --dry-run
```
登录后复制
或
```
composer why-not php:^8.x
```
登录后复制
来检查你的所有依赖是否支持目标PHP版本。很多时候，依赖库本身可能需要升级才能兼容新PHP。
逐步升级与测试： 不要一次性从PHP 5.x跳到PHP 8.x。如果跨度太大，建议逐步升级，例如先升级到7.4，测试稳定后再考虑8.x。每次升级后，都要在独立的开发或测试环境中进行全面而彻底的测试。这包括单元测试、集成测试、端到端测试，以及人工的功能性测试。我通常会搭建一个与生产环境高度相似的Staging环境，在那里进行充分的回归测试。
静态代码分析工具： 使用PHPStan、Psalm或Rector等静态分析工具，它们可以在代码运行前就发现潜在的兼容性问题、类型错误甚至语法错误。Rector甚至可以帮助你自动升级代码以适应新版本。
关注错误日志： 升级后，密切关注Web服务器（Nginx/Apache）和PHP-FPM的错误日志。任何不兼容导致的运行时错误都会在这里留下痕迹。
代码审查： 如果项目中有大量自定义代码，进行一次代码审查，特别关注那些使用了老旧PHP函数、全局变量或不规范写法的代码块。

说实话，PHP版本升级就像是一场“排雷”行动，需要细心、耐心和充分的准备。但一旦成功，你的应用将获得新生，运行得更稳定、更快，也更安全。

如何确保PHP环境的安全性和最佳性能？

搭建好PHP环境只是第一步，要让它在生产环境中稳定、高效、安全地运行，还需要一系列的调优和加固措施。这就像造了一辆车，你还需要给它上保险、定期保养，并根据路况调整驾驶方式。

确保安全性：

隐藏PHP版本信息： 默认情况下，PHP会在HTTP响应头中暴露其版本信息（
```
X-Powered-By: PHP/8.x.x
```
登录后复制
）。这为潜在攻击者提供了便利。在
```
php.ini
```
登录后复制
文件中，找到并设置：
```
expose_php = Off
```
登录后复制
然后重启PHP-FPM服务。
禁用危险函数： PHP提供了许多强大的函数，但有些在Web环境中可能带来安全风险（例如，允许执行系统命令的函数）。在
```
php.ini
```
登录后复制
中，使用
```
disable_functions
```
登录后复制
来禁用它们。常见的被禁用函数包括
```
exec
```
登录后复制
,
```
shell_exec
```
登录后复制
,
```
system
```
登录后复制
,
```
passthru
```
登录后复制
,
```
proc_open
```
登录后复制
,
```
popen
```
登录后复制
,
```
dl
```
登录后复制
,
```
show_source
```
登录后复制
,
```
symlink
```
登录后复制
等。
```
disable_functions = exec,shell_exec,system,passthru,proc_open,popen,dl,show_source,symlink,pcntl_exec,posix_kill,posix_setsid,posix_setuid,posix_setgid,posix_setpgid,posix_setrlimit,posix_setsid,posix_times,posix_ttyname,posix_uname
```
登录后复制
这个列表可以根据你的应用需求进行调整。
限制文件上传： 恶意文件上传是常见的攻击手段。在
```
php.ini
```
登录后复制
中，合理设置
```
upload_max_filesize
```
登录后复制
和
```
post_max_size
```
登录后复制
，并确保上传目录不可执行PHP脚本。
安全配置Nginx/Apache：
- Nginx: 配置
```
location ~ /\.ht
```
  登录后复制
  阻止对
```
.htaccess
```
  登录后复制
  文件的访问（如果你的网站根目录与Apache共享）。确保日志文件有正确的权限。
- 通用: 禁用不必要的HTTP方法（如
```
TRACE
```
  登录后复制
  ,
```
OPTIONS
```
  登录后复制
  ），使用SSL/TLS加密所有通信。
数据库安全：
- 运行
```
mysql_secure_installation
```
  登录后复制
  脚本。
- 为每个应用创建独立的数据库用户，并只赋予其所需的最小权限（Principle of Least Privilege）。
- 使用强密码。
- 不要在代码中硬编码数据库凭据，考虑使用环境变量或密钥管理服务。
文件权限： 确保Web服务器运行的用户（如
```
www-data
```
登录后复制
）只拥有对Web根目录及其子目录的必要读写权限。特别是上传目录和缓存目录，要限制其权限，并确保其他目录不可写。
定期更新： 操作系统、Nginx、PHP、MariaDB以及所有依赖库和应用本身，都应该定期更新到最新稳定版本，以修补已知的安全漏洞。
Web应用防火墙 (WAF)： 考虑使用ModSecurity（Apache）或Naxsi（Nginx）等WAF来过滤恶意请求，例如SQL注入和XSS攻击。

实现最佳性能：

启用并配置OPcache： OPcache是PHP内置的字节码缓存，它能将预编译的PHP脚本字节码存储在共享内存中，避免每次请求都重新解析和编译脚本，从而显著提升PHP应用的性能。它通常默认启用，但你需要确保其配置合理。在
```
php.ini
```
登录后复制
中检查：
```
opcache.enable=1
opcache.memory_consumption=128 ; 根据你的内存大小和应用代码量调整
opcache.interned_strings_buffer=8 ; 字符串缓存
opcache.max_accelerated_files=10000 ; 缓存文件数量
opcache.revalidate_freq=0 ; 生产环境设置为0，避免频繁检查文件修改
```
登录后复制
设置
```
revalidate_freq=0
```
登录后复制
意味着一旦缓存，除非手动清除，否则不会重新检查文件。这在生产环境非常高效，但在开发环境可能需要设置为
```
1
```
登录后复制
或
```
2
```
登录后复制
来快速看到代码修改。
优化PHP-FPM配置： PHP-FPM的进程管理参数对性能至关重要。这些参数在
```
php-fpm.d/www.conf
```
登录后复制
或类似的配置文件中。
- ```
pm = dynamic
```
  登录后复制
  ：动态进程管理，根据负载调整进程数。
- ```
pm.max_children
```
  登录后复制
  ：最大子进程数。
- ```
pm.start_servers
```
  登录后复制
  ：启动时创建的子进程数。
- ```
pm.min_spare_servers
```
  登录后复制
  ：空闲子进程的最小数量。
- ```
pm.max_spare_servers
```
  登录后复制
  ：空闲子进程的最大数量。
- ```
pm.max_requests
```
  登录后复制
  ：每个子进程处理的最大请求数，达到后进程会重启，有助于防止内存泄漏。这些值需要根据你的服务器资源（CPU、内存）和应用负载进行基准测试和调整。一个好的起点是根据内存计算：
```
pm.max_children = 可用内存 / PHP进程平均内存占用
```
  登录后复制
  。
Nginx性能调优：
- ```
worker_processes
```
  登录后复制
  ：通常设置为CPU核心数。
- ```
worker_connections
```
  登录后复制
  ：每个工作进程可以打开的最大连接数。
- ```
gzip on
```
  登录后复制
  ：启用Gzip压缩，减少传输数据量。
- ```
sendfile on
```
  登录后复制
  ：启用零拷贝技术，提高文件传输效率。
- ```
client_max_body_size
```
  登录后复制
  ：限制客户端请求体大小，防止恶意大文件上传。
数据库优化：
- 索引： 确保你的数据库表有合适的索引，特别是那些在
```
WHERE
```
  登录后复制
  、
```
JOIN
```
  登录后复制
  子句中频繁使用的列。
- 慢查询日志： 启用慢查询日志，定期分析并优化执行时间长的SQL语句。
- 连接池： 对于高并发应用，考虑使用数据库连接池来复用数据库连接，减少连接建立和关闭的开销。
- 缓存： 对于不经常变动但频繁读取的数据，使用Redis或Memcached等内存缓存系统。
使用CDN： 对于静态资源（图片、CSS、JS），使用内容分发网络（CDN）可以显著提升加载速度，减轻源服务器的压力。
代码优化： 归根结底，最核心的性能优化还是在应用代码本身。编写高效的PHP代码，避免不必要的循环、重复查询，使用适当的数据结构和算法。