全面详尽的PHP环境搭建教程(包括 Windows、Linux和macOS)

前言

PHP，全称是Hypertext Preprocessor，一种被广泛使用的开源脚本语言，特别适合做Web开发，而且能直接嵌入HTML里。要开始用PHP写代码，第一步当然是在本地或服务器上把PHP的运行环境搭起来。这篇教程会详细拆解如何在Windows、Linux和macOS这三大操作系统上搭建PHP开发环境，手动搭和用集成环境两种方式都会讲到，配置步骤和注意事项也都安排得明明白白，希望能帮大家顺利完成环境搭建，少走弯路。

PHP 环境搭建概述

在写PHP程序之前，得先有个能跑PHP脚本的环境。这个环境通常包含三样东西：

• Web 服务器：比如Apache、Nginx，负责处理HTTP请求。
• PHP 解析器：用来解释和执行PHP脚本。
• 数据库服务器：比如MySQL、MariaDB，用来存数据、管数据。

为了方便开发者，市面上有不少把上面这些组件打包在一起的安装包，比如XAMPP、WAMP、MAMP，一次安装就能搞定所有必要组件，省去了手动配置的麻烦。

在 Windows 上搭建 PHP 环境

使用集成环境 XAMPP

XAMPP 是一个特别省心的选择，它把Apache、MariaDB、PHP和Perl全都打包在一起，Windows、Linux、macOS都能用。对于新手或者想快速搭建环境的开发者来说，用XAMPP再合适不过了。

安装步骤

1. 下载 XAMPP

   去XAMPP官方网站，下载适合Windows的最新版本。

2. 运行安装程序

   双击下载好的安装程序（比如 xampp-windows-x64-8.0.0-0-VC15-installer.exe），可能会弹出用户账户控制（UAC）提示，点“是”继续就行。

3. 选择组件

   在组件选择界面，可以按需勾选要安装的组件。默认情况下，Apache、MySQL、PHP都是选中的。可以根据实际需求，添加或取消其他组件。

   组件	描述
   Apache	Web 服务器
   MySQL	数据库服务器
   PHP	PHP 解析器
   phpMyAdmin	MySQL 管理工具
   FileZilla FTP	FTP 服务器（可选）
   Tomcat	Ja va 服务器（可选）

4. 选择安装目录

   选个安装路径，建议直接装在根目录下（比如 C:\xampp），能避免一些权限问题。

5. 完成安装

   安装完成后，勾选“启动控制面板”选项，然后点“完成”。

配置和测试

1. 启动 Apache 和 MySQL

   在XAMPP控制面板里，点“Start”按钮启动Apache和MySQL服务。

2. 测试 Apache

   在浏览器里输入 http://localhost/，如果能看到XAMPP的欢迎页面，说明Apache跑起来了。

3. 测试 PHP

   创建一个测试文件：

   • 在 C:\xampp\htdocs\ 目录下，新建一个文件，叫 test.php。

   • 文件里写上这个：

   • 在浏览器里访问 http://localhost/test.php，应该会显示出PHP的配置信息页面。

常用配置

• 更改 Apache 端口

  要是端口80被别的程序占了，可以改一下Apache的监听端口。

  • 打开 C:\xampp\apache\conf\httpd.conf。
  • 把 Listen 80 改成 Listen 8080。
  • 把 ServerName localhost:80 改成 ServerName localhost:8080。
  • 重启Apache服务。

• 配置虚拟主机

  如果同时开发多个项目，可以配置虚拟主机来方便管理。

  • 编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf，加上这段：

        DocumentRoot "C:/xampp/htdocs/project1"    ServerName project1.local

    再修改 C:\Windows\System32\drivers\etc\hosts，加上：

    127.0.0.1   project1.local

手动安装 Apache、PHP 和 MySQL

如果对环境的控制要求更高，也可以手动安装和配置每个组件。

安装 Apache

1. 下载 Apache

   去Apache Lounge网站，下载适合Windows的二进制版本。

2. 解压安装

   • 把下载的ZIP文件解压到 C:\Apache24。

3. 配置环境变量

   • 把 C:\Apache24\bin 添加到系统环境变量 PATH 里。

4. 测试安装

   • 打开命令提示符，输入 httpd -v，应该会显示Apache的版本信息。

5. 启动 Apache

   • 以管理员身份运行命令提示符，输入：

     httpd

安装 PHP

1. 下载 PHP

   去PHP官方下载页面，选择适合Windows的非线程安全（NTS）版本。

2. 解压安装

   • 把下载的ZIP文件解压到 C:\PHP。

3. 配置 PHP

   • 把 php.ini-development 重命名为 php.ini。

   • 编辑 php.ini，设置 extension_dir：

     extension_dir = "C:\PHP\ext"

   • 启用必要的扩展，比如 mysqli、pdo_mysql 这些，把前面的分号去掉就行：

     extension=mysqliextension=pdo_mysql

4. 配置 Apache 与 PHP 集成

   • 编辑Apache的配置文件 C:\Apache24\conf\httpd.conf，加上这些内容：

     LoadModule php_module "C:/PHP/php7apache2_4.dll"AddHandler application/x-httpd-php .phpPHPIniDir "C:/PHP"

   • 确保 DocumentRoot 指向你的项目目录。

5. 测试 PHP

   • 在 DocumentRoot 目录下创建 index.php，内容为：

     重启Apache服务，访问 http://localhost/，应该能看到 "Hello, PHP!"。

安装 MySQL

1. 下载 MySQL

   去MySQL官方下载页面，选择适合Windows的MSI安装程序。

2. 安装 MySQL

   • 运行安装程序，选“自定义”安装，按提示完成安装。
   • 配置root用户密码，记好这个密码，后面连接数据库要用。

3. 测试连接

   • 打开命令提示符，输入：

     mysql -u root -p

   • 输入密码后，应该能进入MySQL命令行界面。

配置 PHP 连接 MySQL

• 在 php.ini 里确认已经启用了 mysqli 和 pdo_mysql 扩展。

• 重启Apache服务，测试PHP连接MySQL：

  connect_error) {    die("连接失败: " . $conn->connect_error);}echo "连接成功";?>

在 Linux 上搭建 PHP 环境

Linux是服务器上最常用的操作系统之一，这里以Ubuntu为例，讲讲怎么搭PHP环境。

使用 LAMP 方案

LAMP，就是Linux、Apache、MySQL/MariaDB、PHP的组合，经典的Web开发环境。

安装 Apache

sudo apt updatesudo apt install apache2

安装 MySQL 或 MariaDB

安装 MySQL

sudo apt install mysql-server

安装 MariaDB

sudo apt install mariadb-server

安装 PHP

sudo apt install php libapache2-mod-php php-mysql

配置 Apache

• 设置 Apache 优先解析 PHP 文件

  编辑 /etc/apache2/mods-enabled/dir.conf，把 index.php 放到第一位：

      DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm

• 启用必要的模块

  sudo a2enmod php7.4  # 根据实际 PHP 版本

重启 Apache

sudo systemctl restart apache2

测试 PHP

• 创建测试文件 /var/www/html/info.php，内容为：

• 在浏览器里访问 http://your_server_ip/info.php，应该会显示出PHP的配置信息页面。

安装和配置 Nginx、PHP-FPM 和 MySQL

Nginx是高性能的Web服务器，搭配PHP-FPM能提升PHP应用的性能。

安装 Nginx

sudo apt updatesudo apt install nginx

安装 PHP-FPM

sudo apt install php-fpm php-mysql

配置 Nginx

• 编辑 /etc/nginx/sites-a vailable/default，修改服务器块：

  server {    listen 80;    server_name your_server_ip;    root /var/www/html;    index index.php index.html index.htm;    location / {        try_files $uri $uri/ =404;    }    location ~ \.php$ {        include snippets/fastcgi-php.conf;        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;  # 根据实际 PHP 版本    }    location ~ /\.ht {        deny all;    }}

• 测试Nginx配置：

  sudo nginx -t

• 重启Nginx：

  sudo systemctl restart nginx

测试 PHP

• 创建测试文件 /var/www/html/info.php，内容同上。
• 访问 http://your_server_ip/info.php，应该会显示PHP信息。

在 macOS 上搭建 PHP 环境

使用 MAMP 集成环境

MAMP（Macintosh, Apache, MySQL, PHP）是专门为macOS设计的集成环境。

安装 MAMP

• 下载 MAMP

  去MAMP官方网站，下载最新版本的MAMP。

• 安装 MAMP

  • 双击下载的DMG文件，按提示把MAMP拖到“应用程序”文件夹里。

• 启动 MAMP

  • 进入“应用程序”文件夹，打开MAMP。
  • 点“Start Servers”启动Apache和MySQL。

配置和测试

• 测试 Apache 和 PHP

  • 访问 http://localhost:8888/，应该能看到MAMP的欢迎页面。
  • 默认的Web根目录是 /Applications/MAMP/htdocs。

• 测试 PHP

  • 在 htdocs 目录下创建 test.php，内容为：

  • 访问 http://localhost:8888/test.php，应该会显示PHP信息。

使用 Homebrew 手动安装

Homebrew是macOS上的包管理器，用它来安装Apache、PHP和MySQL很方便。

安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Apache

brew install httpd

• 启动Apache：

  sudo brew services start httpd

安装 PHP

brew install php

• 启动PHP-FPM：

  brew services start php

安装 MySQL

brew install mysql

• 启动MySQL：

  brew services start mysql

配置 Apache

编辑 /usr/local/etc/httpd/httpd.conf，添加或修改以下内容：

加载PHP模块：

LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so

设置DirectoryIndex：

DirectoryIndex index.php index.html

配置PHP文件的处理：

    SetHandler application/x-httpd-php

重启Apache：

sudo brew services restart httpd

测试 PHP

• 在 /usr/local/var/www 目录下创建 index.php，内容为：

• 访问 http://localhost:8080/，应该能看到 "Hello, PHP on macOS!"。

常见问题及解决方案

Apache 无法启动

• 端口被占用

  检查一下是不是有其他服务占用了端口80或8080。

  sudo lsof -i :80

  解决方案：改一下Apache的监听端口，或者停掉占用端口的那个服务。

PHP 脚本不执行，浏览器直接下载

• 未配置 PHP 处理

  确认Web服务器已经正确配置了PHP模块。

  解决方案：按照上面的步骤，确保Apache或Nginx已经加载了PHP模块，或者已经配置好了PHP-FPM。

MySQL 无法连接

• 密码错误

  检查一下连接时用的用户名和密码对不对。

• 服务未启动

  确认MySQL服务已经启动。

  sudo systemctl status mysql

权限问题

• 文件权限不足

  确保Web根目录和PHP文件有正确的权限。

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

防火墙阻止访问

• 检查防火墙设置

  确保服务器的防火墙允许HTTP和HTTPS流量。

  sudo ufw allow 'Apache Full'

总结

搭建PHP开发环境，是开始PHP编程的第一步。不管你是用Windows、Linux还是macOS，这篇教程都提供了详细的步骤和注意事项，希望能帮你顺利搞定环境配置。

• Windows 用户：可以用XAMPP这样的集成环境，快速搭建；也可以手动安装Apache、PHP和MySQL，获得更高的灵活性。
• Linux 用户：LAMP方案是经典选择，或者用Nginx和PHP-FPM来提升性能。
• macOS 用户：MAMP提供了方便的集成环境；通过Homebrew手动安装则能更好地掌控配置。

实际开发中可能会遇到各种问题，这篇教程也提供了一些常见问题的解决方案。希望这篇教程能帮你顺利搭建PHP开发环境，开启你的PHP编程之旅。

参考资料

• PHP 官方文档
• Apache 官方文档
• MySQL 官方文档
• XAMPP 官方网站
• MAMP 官方网站
• Homebrew 官方网站