如何在macOS上设置PHP开发服务器

在macOS系统中设置PHP开发服务器可以满足本地项目调试、功能测试等开发需求，系统本身预装了PHP运行环境，同时也支持搭配常见的Web服务器组件完成更复杂的配置。开发者可以根据项目规模选择不同的搭建方案，小项目可以直接使用PHP内置开发服务器，复杂项目则可以选择Apache或Nginx作为Web服务器配合PHP运行。

一、使用PHP内置开发服务器

PHP自带了轻量级的开发服务器，适合单个项目的快速调试，不需要额外安装Web服务器组件。首先打开macOS的终端应用，确认系统已安装PHP，执行以下命令查看版本：

php -v

如果正常返回版本信息，说明PHP已经可用。接着进入你的PHP项目根目录，执行以下命令启动开发服务器：

# 启动服务器，监听8080端口，默认访问index.php
php -S localhost:8080
# 如果需要指定入口文件，可以添加-t参数指定目录
php -S localhost:8080 -t /path/to/your/project

启动后打开浏览器访问localhost:8080即可看到项目运行效果，停止服务器只需要按终端的Ctrl+C组合键即可。

二、搭配Apache配置PHP开发服务器

macOS系统默认预装了Apache服务器，可以直接启用并配置PHP支持。首先在终端执行命令启动Apache：

# 启动Apache
sudo apachectl start
# 重启Apache
sudo apachectl restart
# 停止Apache
sudo apachectl stop

启动后可以访问localhost看到Apache的默认页面。接下来需要让Apache支持PHP，编辑Apache的配置文件：

sudo nano /etc/apache2/httpd.conf

在配置文件中找到以下行，去掉前面的#注释符号来启用PHP模块：

LoadModule php_module libexec/apache2/libphp.so

同时可以修改Apache的默认站点目录，找到DocumentRoot配置项，将其修改为你的PHP项目存放路径：

DocumentRoot "/Users/your_username/Sites"
<Directory "/Users/your_username/Sites">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

修改完成后保存配置，重启Apache服务即可通过localhost访问你的PHP项目。

三、搭配Nginx配置PHP开发服务器

如果需要使用Nginx作为Web服务器，首先需要通过Homebrew安装Nginx和PHP的相关扩展，先确保已经安装Homebrew，然后执行以下命令：

# 安装Nginx
brew install nginx
# 安装PHP FPM
brew install php

安装完成后启动PHP FPM和Nginx服务：

# 启动PHP FPM
brew services start php
# 启动Nginx
brew services start nginx

接下来编辑Nginx的配置文件，默认路径为/usr/local/etc/nginx/nginx.conf，在server配置块中添加PHP的处理规则：

server {
    listen       8080;
    server_name  localhost;
    # 项目根目录
    root   /Users/your_username/Sites;
    index  index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # PHP文件处理配置
    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

配置完成后重启Nginx服务，访问localhost:8080即可运行PHP项目。

不同方案对比

PHPmacOSPHP_development_serverApacheNginx修改时间：2026-06-03 23:24:28