Ubuntu 搭建 Nginx + PHP 运行环境指南

季宁
季宁
发布时间:2026-10-14| 4人浏览过
原创

在 Ubuntu 系统中搭建基于 Nginx 和 PHP-FPM 的 Web 环境,通常比传统的 Apache 架构更轻量。本教程将引导你完成从软件安装到核心配置的全部过程,使其能够正常解析 PHP 脚本。

结果或目标

完成本教程后,你将拥有一个能响应 HTTP 请求、并能执行 .php 文件的 Nginx 服务器。同时可自定义网站根目录及默认主页文件。

准备条件

root 权限(需使用 sudo)。 已安装 Ubuntu 操作系统(本示例基于经典版本测试,但适用于大多数现代 Debian 系发行版)。

真实操作顺序

第1步:安装核心软件包

目的:获取 Nginx 服务器程序及 PHP FastCGI 进程管理器。

  • 入口:终端命令行。
  • 动作:执行以下命令同步安装 Nginx 和 PHP5-FPM。
sudo apt-get install nginx php5-fpm

注意:虽然此命令在旧版本中直接有效,现代 Linux 发行版可能需要指定确切的 PHP 版本号(如 php-fpm 或 php8.1-fpm),请以实际系统仓库提供的软件包名称为准。

第2步:修改 Nginx 配置文件

目的:指示 Nginx 将传入的 PHP 请求传递给 PHP-FPM 进程处理。

  • 入口:终端命令行。
  • 动作:编辑 Nginx 站点默认配置文件。
sudo gedit /etc/nginx/sites-available/default

风险提示:使用图形编辑器(如 gedit)保存时可能会生成备份文件(如 default~)。Nginx 如果意外读取了该备份文件可能导致启动失败。为确保安全,请在保存后检查并确保 sites-enabled 目录下仅存在软链接指向 sites-available 的正确配置文件,手动删除任何多余的备份文件。

参数修改: 在配置文件中找到 location ~ \.php$ { ... } 块,取消相关注释以启用 PHP 处理。关键行应包含以下内容:

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
    }

重要参数说明: fastcgi_pass 指向的是 PHP-FPM 的 Unix Socket 路径。不同版本的 PHP 其 Socket 文件名可能不同(例如 php7.0-fpm.sock),请根据实际安装的版本确认路径正确性。

第3步:启动服务

目的:使配置生效。

  • 动作:重启或启动 Nginx 服务。
sudo service nginx start

扩展设置

默认主页支持 PHP

若希望访问域名时自动显示 index.php,需在 server {} 块中找到 index 指令,追加 index.php:

index index.html index.htm index.php;

开启目录自动索引

当访问某个 URL 且目录下没有上述默认主页文件时,可通过添加以下指令列出目录下所有文件:

autoindex on;

将该行放入 location / { } 代码块内。

修改网站根目录

Nginx 配置文件中的 root 指令定义了服务器文件的存放位置。根据需要将路径修改为你存放网页的实际文件夹即可。

简要总结

通过安装 Nginx 与 PHP-FPM 并修正其连接配置,即可在 Ubuntu 上构建高效的 Web 服务环境。关键在于确保 Nginx 配置的 fastcgi_pass 地址与实际运行的 PHP 进程套接字一致。

以上就是在 Ubuntu 中搭建 Nginx 和 PHP 环境的详细内容,更多关于 Linux 服务器配置的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。