Ubuntu搭建PHP本地开发环境有四种方式:一、Apache+PHP(LAMP),二、Nginx+PHP-FPM(轻量高效),三、Docker(隔离多版本),四、PHP内置服务器(快速调试)。

如果您希望在 Ubuntu 系统上快速启动 PHP 开发项目,但尚未配置可运行的本地环境,则可能是由于缺少 Web 服务器、PHP 解释器或相关扩展组件。以下是针对 Ubuntu 系统搭建 PHP 本地开发环境的具体流程:
一、使用 Apache + PHP(传统 LAMP 方式)
该方式通过安装 Apache Web 服务器与 PHP 运行时组合,构成稳定且兼容性广的本地开发环境,适用于需要完整 Web 服务功能的项目。
1、更新系统软件包索引:
执行 sudo apt update。
2、安装 Apache 服务器:
执行 sudo apt install apache2。
立即学习“PHP免费学习笔记(深入)”;
3、安装 PHP 及常用扩展:
执行 sudo apt install php libapache2-mod-php php-mysql php-curl php-gd php-mbstring php-xml php-xmlrpc php-zip。
4、重启 Apache 使 PHP 模块生效:
执行 sudo systemctl restart apache2。
5、在 /var/www/html/ 目录下创建 info.php 文件,内容为 ,然后通过浏览器访问 http://localhost/info.php 验证环境。
二、使用 Nginx + PHP-FPM(轻量高效方式)
该方式采用事件驱动的 Nginx 作为 Web 服务器,配合 PHP-FPM 处理动态请求,资源占用更低,适合对响应速度和并发能力有要求的本地调试场景。
1、卸载可能冲突的 Apache(如已安装):
执行 sudo apt remove --purge apache2 apache2-utils apache2-bin apache2-common,再执行 sudo apt autoremove。
2、安装 Nginx 和 PHP-FPM:
执行 sudo apt install nginx php-fpm。
3、配置 Nginx 使用 PHP-FPM:
编辑 /etc/nginx/sites-available/default,在 server 块内找到 location ~ \.php$ 区域,确保包含 fastcgi_pass unix:/run/php/php8.1-fpm.sock;(版本号需与实际安装一致)及 include snippets/fastcgi-php.conf;。
4、测试配置并重载 Nginx:
执行 sudo nginx -t 验证语法,成功后执行 sudo systemctl reload nginx。
5、将测试文件置于 /var/www/html/,访问 http://localhost/info.php 查看 PHP 信息页。
三、使用 Docker 快速构建隔离环境
该方式无需在宿主机安装任何服务组件,所有依赖均封装于容器中,可实现多版本 PHP 并存、项目间环境隔离,避免系统级依赖冲突。
1、安装 Docker 和 Docker Compose:
执行 sudo apt install docker.io docker-compose,并添加当前用户到 docker 组:sudo usermod -aG docker $USER,随后重启终端或执行 newgrp docker。
2、创建项目目录并进入:
执行 mkdir myphpapp && cd myphpapp。
3、新建 docker-compose.yml,内容包含 nginx、php 和 mysql 服务定义,并挂载本地代码目录至容器内 /var/www/html。
4、在项目根目录下创建 index.php,内容为 。
5、启动服务:
执行 docker-compose up -d,然后访问 http://localhost 查看输出结果。
四、使用 PHP 内置开发服务器(极简单文件调试)
该方式不依赖外部 Web 服务器,仅利用 PHP 自带的 CLI 服务器,适用于快速验证单个脚本或小型静态路由应用,启动最快但不支持 .htaccess 或复杂 rewrite 规则。
1、确认已安装 PHP(至少 5.4+):
执行 php -v 查看版本。
2、创建一个含 index.php 的项目目录,并确保其中存在可执行的 PHP 脚本。
3、在项目根目录执行内置服务器命令:
执行 php -S localhost:8000(若需指定路由器脚本则加参数 -t ./public router.php)。
4、打开浏览器访问 http://localhost:8000 即可加载当前目录下的 index.php。
5、如需终止服务,在终端按 Ctrl+C。











