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

洁曦 發表於 2026-5-3 17:25:23

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

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">前言</a></li><li><a href="#_label1">PHP 环境搭建概述</a></li><li><a href="#_label2">在 Windows 上搭建 PHP 环境</a></li><ul class="second_class_ul"><li><a href="#_lab2_2_0">使用集成环境 XAMPP</a></li><ul class="third_class_ul"><li><a href="#_label3_2_0_0">安装步骤</a></li><li><a href="#_label3_2_0_1">配置和测试</a></li><li><a href="#_label3_2_0_2">常用配置</a></li></ul><li><a href="#_lab2_2_1">手动安装 Apache、PHP 和 MySQL</a></li><ul class="third_class_ul"><li><a href="#_label3_2_1_3">安装 Apache</a></li><li><a href="#_label3_2_1_4">安装 PHP</a></li><li><a href="#_label3_2_1_5">安装 MySQL</a></li><li><a href="#_label3_2_1_6">配置 PHP 连接 MySQL</a></li></ul></ul><li><a href="#_label3">&nbsp;在 Linux 上搭建 PHP 环境</a></li><ul class="second_class_ul"><li><a href="#_lab2_3_2">使用 LAMP 方案</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_3">安装 Apache</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_4">安装 MySQL 或 MariaDB</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_5">安装 PHP</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_6">配置 Apache</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_7">重启 Apache</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_8">测试 PHP</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_9">安装和配置 Nginx、PHP-FPM 和 MySQL</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_10">安装 Nginx</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_11">安装 PHP-FPM</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_12">配置 Nginx</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_3_13">测试 PHP</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label4">在 macOS 上搭建 PHP 环境</a></li><ul class="second_class_ul"><li><a href="#_lab2_4_14">使用 MAMP 集成环境</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_15">安装 MAMP</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_16">配置和测试</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_17">使用 Homebrew 手动安装</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_18">安装 Homebrew</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_19">安装 Apache</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_20">安装 PHP</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_21">安装 MySQL</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_22">配置 Apache</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_4_23">测试 PHP</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label5">常见问题及解决方案</a></li><ul class="second_class_ul"><li><a href="#_lab2_5_24">Apache 无法启动</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_5_25">PHP 脚本不执行，浏览器直接下载</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_5_26">MySQL 无法连接</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_5_27">权限问题</a></li><ul class="third_class_ul"></ul><li><a href="#_lab2_5_28">防火墙阻止访问</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label6">总结</a></li><ul class="second_class_ul"></ul><li><a href="#_label7">参考资料</a></li><ul class="second_class_ul"></ul></ul></div><p class="maodian"><a name="_label0"></a></p><h2>前言</h2>
<p>PHP（Hypertext Preprocessor）是一种广泛应用的开源脚本语言，特别适用于 Web 开发，并可嵌入 HTML 中。为了开始使用 PHP，首先需要在本地或服务器上搭建一个 PHP 运行环境。本教程将详细介绍如何在不同操作系统下搭建 PHP 开发环境，包括 Windows、Linux 和 macOS。我们将涵盖手动搭建和使用集成环境两种方式，并提供完整的配置步骤和注意事项，帮助您顺利完成环境搭建。</p>
<p class="maodian"><a name="_label1"></a></p><h2>PHP 环境搭建概述</h2>
<p>在开始编写 PHP 程序之前，需要搭建一个能运行 PHP 脚本的环境。通常，这个环境包括：</p>
<ul><li><strong>Web 服务器</strong>：如 Apache、Nginx 等，用于处理 HTTP 请求。</li><li><strong>PHP 解析器</strong>：解释和运行 PHP 脚本。</li><li><strong>数据库服务器</strong>：如 MySQL、MariaDB，用于存储和管理数据。</li></ul>
<p>为了方便开发者，市面上有许多集成了以上组件的安装包，如 XAMPP、WAMP、MAMP 等，它们可以一次性安装所有必要的组件，节省配置时间。</p>
<p class="maodian"><a name="_label2"></a></p><h2>在 Windows 上搭建 PHP 环境</h2>
<p class="maodian"><a name="_lab2_2_0"></a></p><h3>使用集成环境 XAMPP</h3>
<p>XAMPP 是一种易于安装的 Apache 发行版，包含 MariaDB、PHP 和 Perl，适用于 Windows、Linux 和 macOS。对于初学者和需要快速搭建环境的开发者来说，XAMPP 是一个理想的选择。</p>
<p class="maodian"><a name="_label3_2_0_0"></a></p><h4>安装步骤</h4>
<ol><li><p><strong>下载 XAMPP</strong></p>
<p>访问 XAMPP 官方网站，下载适用于 Windows 的最新版本。</p></li><li><p><strong>运行安装程序</strong></p>
<p>双击下载的安装程序（如 <code>xampp-windows-x64-8.0.0-0-VC15-installer.exe</code>），可能会出现用户账户控制（UAC）提示，点击&ldquo;是&rdquo;继续。</p></li><li><p><strong>选择组件</strong></p>
<p>在组件选择界面，可以选择需要安装的组件。默认情况下，Apache、MySQL、PHP 都会被选中。根据需求，可以添加或取消其他组件。</p>
<table><thead><tr><th>组件</th><th>描述</th></tr></thead><tbody><tr><td>Apache</td><td>Web 服务器</td></tr><tr><td>MySQL</td><td>数据库服务器</td></tr><tr><td>PHP</td><td>PHP 解析器</td></tr><tr><td>phpMyAdmin</td><td>MySQL 管理工具</td></tr><tr><td>FileZilla FTP</td><td>FTP 服务器（可选）</td></tr><tr><td>Tomcat</td><td>Java 服务器（可选）</td></tr></tbody></table></li><li><p><strong>选择安装目录</strong></p>
<p>选择安装路径，建议安装在根目录下（如 <code>C:\xampp</code>），避免权限问题。</p></li><li><p><strong>完成安装</strong></p>
<p>安装完成后，勾选&ldquo;启动控制面板&rdquo;选项，点击&ldquo;完成&rdquo;。</p></li></ol>
<p class="maodian"><a name="_label3_2_0_1"></a></p><h4>配置和测试</h4>
<ol><li><p><strong>启动 Apache 和 MySQL</strong></p>
<p>在 XAMPP 控制面板中，点击&ldquo;Start&rdquo;按钮启动 Apache 和 MySQL 服务。</p></li><li><p><strong>测试 Apache</strong></p>
<p>在浏览器中输入 <code>http://localhost/</code>，如果看到 XAMPP 欢迎页面，说明 Apache 运行正常。</p></li><li><p><strong>测试 PHP</strong></p>
<p>创建一个测试文件：</p>
<ul><li><p>在 <code>C:\xampp\htdocs\</code> 目录下，新建一个文件 <code>test.php</code>。</p></li><li><p>在文件中输入以下内容：</p>
<pre>
</pre>
<div class="jb51code"><pre class="brush:php;">&lt;?php
phpinfo();
?&gt;
</pre></div></li><li><p>在浏览器中访问 <code>http://localhost/test.php</code>，应显示 PHP 配置信息页面。</p></li></ul></li></ol>
<p class="maodian"><a name="_label3_2_0_2"></a></p><h4>常用配置</h4>
<ul><li><p><strong>更改 Apache 端口</strong></p>
<p>如果端口 80 被占用，可以修改 Apache 的监听端口。</p>
<ul><li>打开 <code>C:\xampp\apache\conf\httpd.conf</code>。</li><li>将 <code>Listen 80</code> 改为 <code>Listen 8080</code>。</li><li>将 <code>ServerName localhost:80</code> 改为 <code>ServerName localhost:8080</code>。</li><li>重启 Apache 服务。</li></ul></li><li><p><strong>配置虚拟主机</strong></p>
<p>在开发多个项目时，可以配置虚拟主机方便管理。</p>
<ul><li><p>编辑 <code>C:\xampp\apache\conf\extra\httpd-vhosts.conf</code>，添加：</p>
<pre>
</pre>
<div class="jb51code"><pre class="brush:php;">&lt;VirtualHost *:80&gt;
    DocumentRoot "C:/xampp/htdocs/project1"
    ServerName project1.local
&lt;/VirtualHost&gt;
</pre></div>
<p>修改 <code>C:\Windows\System32\drivers\etc\hosts</code>，添加：</p>
<pre>
</pre>
<div class="jb51code"><pre class="brush:php;">127.0.0.1   project1.local
</pre></div></li></ul></li></ul>
<p class="maodian"><a name="_lab2_2_1"></a></p><h3>手动安装 Apache、PHP 和 MySQL</h3>
<p>对于需要更高控制度的开发者，可以手动安装和配置各个组件。</p>
<p class="maodian"><a name="_label3_2_1_3"></a></p><h4>安装 Apache</h4>
<ol><li><p><strong>下载 Apache</strong></p>
<p>访问 Apache Lounge，下载适用于 Windows 的二进制版本。</p></li><li><p><strong>解压安装</strong></p>
<ul><li>将下载的 ZIP 文件解压到 <code>C:\Apache24</code>。</li></ul></li><li><p><strong>配置环境变量</strong></p>
<ul><li>将 <code>C:\Apache24\bin</code> 添加到系统环境变量 <code>PATH</code> 中。</li></ul></li><li><p><strong>测试安装</strong></p>
<ul><li>打开命令提示符，输入 <code>httpd -v</code>，应显示 Apache 版本信息。</li></ul></li><li><p><strong>启动 Apache</strong></p>
<ul><li><p>以管理员身份运行命令提示符，输入：</p>
<pre>httpd
</pre></li></ul></li></ol>
<p class="maodian"><a name="_label3_2_1_4"></a></p><h4>安装 PHP</h4>
<ol><li><p><strong>下载 PHP</strong></p>
<p>访问 <a href="https://windows.php.net/download/" rel="external nofollow" target="_blank" title="PHP 官方下载页面">PHP 官方下载页面</a>，选择适用于 Windows 的非线程安全（NTS）版本。</p></li><li><p><strong>解压安装</strong></p>
<ul><li>将下载的 ZIP 文件解压到 <code>C:\PHP</code>。</li></ul></li><li><p><strong>配置 PHP</strong></p>
<ul><li><p>将 <code>php.ini-development</code> 重命名为 <code>php.ini</code>。</p></li><li><p>编辑 <code>php.ini</code>，设置 <code>extension_dir</code>：</p>
<div class="jb51code"><pre class="brush:php;">extension_dir = "C:\PHP\ext"</pre></div></li><li><p>启用必要的扩展，如 <code>mysqli</code>、<code>pdo_mysql</code> 等，去掉前面的分号：</p>
<div class="jb51code"><pre class="brush:php;">extension=mysqli
extension=pdo_mysql</pre></div></li></ul></li><li><p><strong>配置 Apache 与 PHP 集成</strong></p>
<ul><li><p>编辑 Apache 的配置文件 <code>C:\Apache24\conf\httpd.conf</code>，添加以下内容：</p>
<div class="jb51code"><pre class="brush:php;">LoadModule php_module "C:/PHP/php7apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/PHP"</pre></div></li><li><p>确保 <code>DocumentRoot</code> 指向您的项目目录。</p></li></ul></li><li><p><strong>测试 PHP</strong></p>
<ul><li><p>在 <code>DocumentRoot</code> 目录下创建 <code>index.php</code>，内容为：</p>
<div class="jb51code"><pre class="brush:php;">&lt;?php
echo "Hello, PHP!";
?&gt;</pre></div>
<p>重启 Apache 服务，访问 <code>http://localhost/</code>，应显示 &quot;Hello, PHP!&quot;。</p></li></ul></li></ol>
<p class="maodian"><a name="_label3_2_1_5"></a></p><h4>安装 MySQL</h4>
<ol><li><p><strong>下载 MySQL</strong></p>
<p>访问 <a href="https://dev.mysql.com/downloads/mysql/" rel="external nofollow" target="_blank" title="MySQL 官方下载页面">MySQL 官方下载页面</a>，选择适用于 Windows 的 MSI 安装程序。</p></li><li><p><strong>安装 MySQL</strong></p>
<ul><li>运行安装程序，选择&ldquo;自定义&rdquo;安装，按照提示完成安装。</li><li>配置 root 用户密码，记住该密码用于后续连接。</li></ul></li><li><p><strong>测试连接</strong></p>
<ul><li><p>打开命令提示符，输入：</p>
<pre>mysql -u root -p
</pre></li><li><p>输入密码后，应进入 MySQL 命令行界面。</p></li></ul></li></ol>
<p class="maodian"><a name="_label3_2_1_6"></a></p><h4>配置 PHP 连接 MySQL</h4>
<ul><li><p>在 <code>php.ini</code> 中确保已启用 <code>mysqli</code> 和 <code>pdo_mysql</code> 扩展。</p></li><li><p>重启 Apache 服务，测试 PHP 连接 MySQL：</p>
<div class="jb51code"><pre class="brush:php;">&lt;?php
$conn = new mysqli("localhost", "root", "yourpassword");
if ($conn-&gt;connect_error) {
    die("连接失败: " . $conn-&gt;connect_error);
}
echo "连接成功";
?&gt;</pre></div></li></ul>
<p class="maodian"><a name="_label3"></a></p><h2>&nbsp;在 Linux 上搭建 PHP 环境</h2>
<p>Linux 是服务器最常用的操作系统之一，以下以 Ubuntu 为例介绍如何搭建 PHP 环境。</p>
<p class="maodian"><a name="_lab2_3_2"></a></p><h3>使用 LAMP 方案</h3>
<p>LAMP 代表 Linux、Apache、MySQL/MariaDB、PHP 的组合，是经典的 Web 开发环境。</p>
<p class="maodian"><a name="_lab2_3_3"></a></p><p class="maodian"><a name="_lab2_4_19"></a></p><h3>安装 Apache</h3>
<div class="jb51code"><pre class="brush:ps;">sudo apt update
sudo apt install apache2</pre></div>
<p class="maodian"><a name="_lab2_3_4"></a></p><h3>安装 MySQL 或 MariaDB</h3>
<p><strong>安装 MySQL</strong></p>
<div class="jb51code"><pre class="brush:ps;">sudo apt install mysql-server</pre></div>
<p><strong>安装 MariaDB</strong></p>
<div class="jb51code"><pre class="brush:ps;">sudo apt install mariadb-server</pre></div>
<p class="maodian"><a name="_lab2_3_5"></a></p><p class="maodian"><a name="_lab2_4_20"></a></p><h3>安装 PHP</h3>
<div class="jb51code"><pre class="brush:ps;">sudo apt install php libapache2-mod-php php-mysql</pre></div>
<p class="maodian"><a name="_lab2_3_6"></a></p><p class="maodian"><a name="_lab2_4_22"></a></p><h3>配置 Apache</h3>
<ul><li><p><strong>设置 Apache 优先解析 PHP 文件</strong></p>
<p>编辑 <code>/etc/apache2/mods-enabled/dir.conf</code>，将 <code>index.php</code> 放在第一位：</p>
<div class="jb51code"><pre class="brush:php;">&lt;IfModule mod_dir.c&gt;
    DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm
&lt;/IfModule&gt;</pre></div></li><li><p><strong>启用必要的模块</strong></p>
<div class="jb51code"><pre class="brush:php;">sudo a2enmod php7.4# 根据实际 PHP 版本</pre></div></li></ul>
<p class="maodian"><a name="_lab2_3_7"></a></p><h3>重启 Apache</h3>
<div class="jb51code"><pre class="brush:ps;">sudo systemctl restart apache2</pre></div>
<p class="maodian"><a name="_lab2_3_8"></a></p><p class="maodian"><a name="_lab2_3_13"></a></p><p class="maodian"><a name="_lab2_4_23"></a></p><h3>测试 PHP</h3>
<ul><li><p>创建测试文件 <code>/var/www/html/info.php</code>，内容为：</p>
<div class="jb51code"><pre class="brush:php;">&lt;?php
phpinfo();
?&gt;</pre></div></li><li><p>在浏览器中访问 <code>http://your_server_ip/info.php</code>，应显示 PHP 配置信息页面。</p></li></ul>
<p class="maodian"><a name="_lab2_3_9"></a></p><h3>安装和配置 Nginx、PHP-FPM 和 MySQL</h3>
<p>Nginx 是高性能的 Web 服务器，搭配 PHP-FPM 可以提高 PHP 应用的性能。</p>
<p class="maodian"><a name="_lab2_3_10"></a></p><h3>安装 Nginx</h3>
<div class="jb51code"><pre class="brush:ps;">sudo apt update
sudo apt install nginx</pre></div>
<p class="maodian"><a name="_lab2_3_11"></a></p><h3>安装 PHP-FPM</h3>
<div class="jb51code"><pre class="brush:ps;">sudo apt install php-fpm php-mysql</pre></div>
<p class="maodian"><a name="_lab2_3_12"></a></p><h3>配置 Nginx</h3>
<ul><li><p>编辑 <code>/etc/nginx/sites-available/default</code>，修改服务器块：</p>
<div class="jb51code"><pre class="brush:plain;">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;
    }
}</pre></div></li><li><p>测试 Nginx 配置：</p>
<div class="jb51code"><pre class="brush:ps;">sudo nginx -t</pre></div></li><li><p>重启 Nginx：</p>
<div class="jb51code"><pre class="brush:ps;">sudo systemctl restart nginx</pre></div></li></ul>
<h3>测试 PHP</h3>
<ul><li>创建测试文件 <code>/var/www/html/info.php</code>，内容同上。</li><li>访问 <code>http://your_server_ip/info.php</code>，应显示 PHP 信息。</li></ul>
<p class="maodian"><a name="_label4"></a></p><h2>在 macOS 上搭建 PHP 环境</h2>
<p class="maodian"><a name="_lab2_4_14"></a></p><h3>使用 MAMP 集成环境</h3>
<p>MAMP（Macintosh, Apache, MySQL, PHP）是专为 macOS 设计的集成环境。</p>
<p class="maodian"><a name="_lab2_4_15"></a></p><h3>安装 MAMP</h3>
<ul><li><p><strong>下载 MAMP</strong></p>
<p>访问 MAMP 官方网站，下载最新版本的 MAMP。</p></li><li><p><strong>安装 MAMP</strong></p>
<ul><li>双击下载的 DMG 文件，按照提示拖动 MAMP 到&ldquo;应用程序&rdquo;文件夹。</li></ul></li><li><p><strong>启动 MAMP</strong></p>
<ul><li>进入&ldquo;应用程序&rdquo;文件夹，打开 MAMP。</li><li>点击&ldquo;Start Servers&rdquo;启动 Apache 和 MySQL。</li></ul></li></ul>
<p class="maodian"><a name="_lab2_4_16"></a></p><h3>配置和测试</h3>
<ul><li><p><strong>测试 Apache 和 PHP</strong></p>
<ul><li>访问 <code>http://localhost:8888/</code>，应看到 MAMP 欢迎页面。</li><li>默认的 Web 根目录是 <code>/Applications/MAMP/htdocs</code>。</li></ul></li><li><p><strong>测试 PHP</strong></p>
<ul><li><p>在 <code>htdocs</code> 目录下创建 <code>test.php</code>，内容为：</p>
<div class="jb51code"><pre class="brush:php;">&lt;?php
phpinfo();
?&gt;</pre></div></li><li><p>访问 <code>http://localhost:8888/test.php</code>，应显示 PHP 信息。</p></li></ul></li></ul>
<p class="maodian"><a name="_lab2_4_17"></a></p><h3>使用 Homebrew 手动安装</h3>
<p>Homebrew 是 macOS 上的包管理器，可以方便地安装 Apache、PHP 和 MySQL。</p>
<p class="maodian"><a name="_lab2_4_18"></a></p><h3>安装 Homebrew</h3>
<div class="jb51code"><pre class="brush:ps;">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</pre></div>
<h3>安装 Apache</h3>
<div class="jb51code"><pre class="brush:ps;">brew install httpd</pre></div>
<ul><li><p>启动 Apache：</p>
<div class="jb51code"><pre class="brush:ps;">sudo brew services start httpd</pre></div></li></ul>
<h3>安装 PHP</h3>
<div class="jb51code"><pre class="brush:ps;">brew install php</pre></div>
<ul><li><p>启动 PHP-FPM：</p>
<div class="jb51code"><pre class="brush:ps;">brew services start php</pre></div></li></ul>
<p class="maodian"><a name="_lab2_4_21"></a></p><h3>安装 MySQL</h3>
<div class="jb51code"><pre class="brush:xhtml;">brew install mysql</pre></div>
<ul><li><p>启动 MySQL：</p>
<div class="jb51code"><pre class="brush:ps;">brew services start mysql</pre></div></li></ul>
<h3>配置 Apache</h3>
<p>编辑 /usr/local/etc/httpd/httpd.conf，添加或修改以下内容：</p>
<p>加载 PHP 模块：</p>
<div class="jb51code"><pre class="brush:ps;">LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so
</pre></div>
<p>设置 DirectoryIndex：</p>
<div class="jb51code"><pre class="brush:ps;">DirectoryIndex index.php index.html</pre></div>
<p>配置 PHP 文件的处理：</p>
<div class="jb51code"><pre class="brush:xml;">&lt;FilesMatch \.php$&gt;
    SetHandler application/x-httpd-php
&lt;/FilesMatch&gt;</pre></div>
<p>重启 Apache：</p>
<div class="jb51code"><pre class="brush:ps;">sudo brew services restart httpd
</pre></div>
<h3>测试 PHP</h3>
<ul><li><p>在 <code>/usr/local/var/www</code> 目录下创建 <code>index.php</code>，内容为：</p>
<div class="jb51code"><pre class="brush:php;">&lt;?php
echo "Hello, PHP on macOS!";
?&gt;</pre></div></li><li><p>访问 <code>http://localhost:8080/</code>，应显示 &quot;Hello, PHP on macOS!&quot;。</p></li></ul>
<p class="maodian"><a name="_label5"></a></p><h2>常见问题及解决方案</h2>
<p class="maodian"><a name="_lab2_5_24"></a></p><h3>Apache 无法启动</h3>
<ul><li><p><strong>端口被占用</strong></p>
<p>检查是否有其他服务占用了端口 80 或 8080。</p>
<div class="jb51code"><pre class="brush:ps;">sudo lsof -i :80</pre></div>
<p><strong>解决方案</strong>：更改 Apache 的监听端口，或停止占用端口的服务。</p></li></ul>
<p class="maodian"><a name="_lab2_5_25"></a></p><h3>PHP 脚本不执行，浏览器直接下载</h3>
<ul><li><p><strong>未配置 PHP 处理</strong></p>
<p>确认 Web 服务器已正确配置 PHP 模块。</p>
<p><strong>解决方案</strong>：按照上述步骤，确保 Apache 或 Nginx 已加载 PHP 模块或已配置 PHP-FPM。</p></li></ul>
<p class="maodian"><a name="_lab2_5_26"></a></p><h3>MySQL 无法连接</h3>
<ul><li><p><strong>密码错误</strong></p>
<p>检查连接时使用的用户名和密码是否正确。</p></li><li><p><strong>服务未启动</strong></p>
<p>确认 MySQL 服务已启动。</p>
<div class="jb51code"><pre class="brush:ps;">sudo systemctl status mysql</pre></div></li></ul>
<p class="maodian"><a name="_lab2_5_27"></a></p><h3>权限问题</h3>
<ul><li><p><strong>文件权限不足</strong></p>
<p>确保 Web 根目录和 PHP 文件具有正确的权限。</p>
<div class="jb51code"><pre class="brush:ps;">sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html</pre></div></li></ul>
<p class="maodian"><a name="_lab2_5_28"></a></p><h3>防火墙阻止访问</h3>
<ul><li><p><strong>检查防火墙设置</strong></p>
<p>确保服务器的防火墙允许 HTTP 和 HTTPS 流量。</p>
<div class="jb51code"><pre class="brush:ps;">sudo ufw allow 'Apache Full'</pre></div></li></ul>
<p class="maodian"><a name="_label6"></a></p><h2>总结</h2>
<p>搭建 PHP 开发环境是开始 PHP 编程的第一步。无论您使用的是 Windows、Linux 还是 macOS，本教程都提供了详细的步骤和注意事项，帮助您顺利完成环境配置。</p>
<ul><li><strong>Windows 用户</strong>：可以选择使用 XAMPP 这样的集成环境，快速搭建开发环境；也可以手动安装 Apache、PHP 和 MySQL，获得更高的灵活性。</li><li><strong>Linux 用户</strong>：LAMP 方案是经典的选择，或者使用 Nginx 和 PHP-FPM 提升性能。</li><li><strong>macOS 用户</strong>：MAMP 提供了方便的集成环境；通过 Homebrew 手动安装则能更好地掌控配置。</li></ul>
<p>在实际开发中，可能会遇到各种问题，本教程也提供了一些常见问题的解决方案。希望本教程能帮助您顺利搭建 PHP 开发环境，开启您的 PHP 编程之旅。</p>
<p class="maodian"><a name="_label7"></a></p><h2>参考资料</h2>
<ul><li><a href="https://www.php.net/manual/zh/install.php" rel="nofollow" target="_blank">PHP 官方文档</a></li><li><a href="https://httpd.apache.org/docs/" rel="nofollow" target="_blank">Apache 官方文档</a></li><li><a href="https://dev.mysql.com/doc/" rel="nofollow" target="_blank">MySQL 官方文档</a></li><li>XAMPP 官方网站</li><li>MAMP 官方网站</li><li>Homebrew 官方网站</li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202510/2025103010230864.jpg" /></p>

查看完整版本: 全面详尽的PHP环境搭建教程(包括 Windows、Linux和macOS)