0

0

如何使用Valet在Mac搭建PHP环境 MacOS下快速PHP站点部署方式

絕刀狂花

絕刀狂花

发布时间:2025-07-23 17:24:02

|

288人浏览过

|

来源于php中文网

原创

在macos上使用valet部署php站点的核心步骤为:1. 安装homebrew;2. 安装composer;3. 全局安装valet;4. 执行valet install配置服务;5. 使用valet park或valet link部署项目。valet通过nginx、dnsmasq和php fpm实现“零配置”本地php站点运行,无需虚拟主机设置,资源占用低,操作简洁高效。相比mamp、xampp等集成环境,valet更轻量且专注web服务器核心功能,不捆绑数据库和图形界面,适合多项目快速切换。常见问题如服务异常可通过valet restart解决,php版本切换支持全局设置,域名解析问题可借助valet diagnose或重装valet处理。valet内置多种框架驱动,如laravel、wordpress等,自动识别并优化配置,提升开发效率。

如何使用Valet在Mac搭建PHP环境 MacOS下快速PHP站点部署方式

在macOS上快速搭建PHP开发环境,Valet无疑是我用过最简洁、高效的工具。它巧妙地利用Nginx、DnsMasq和PHP FPM,以极低的资源占用和“零配置”的理念,让你能够瞬间启动并运行本地PHP站点,无需繁琐的虚拟主机设置或庞大的集成环境。

如何使用Valet在Mac搭建PHP环境 MacOS下快速PHP站点部署方式

解决方案

要使用Valet在Mac上部署PHP站点,核心步骤非常直接。我个人觉得,它把那些复杂的服务配置都封装得很好,你只需要几个命令就能搞定。

首先,确保你的Mac上安装了Homebrew,这是macOS上包管理的基石。如果你还没装,终端里跑一下这个:

立即学习PHP免费学习笔记(深入)”;

如何使用Valet在Mac搭建PHP环境 MacOS下快速PHP站点部署方式
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew搞定后,我们需要Composer,PHP的依赖管理工具。Valet本身就是通过Composer安装的。

brew install composer

接着,就是安装Valet本体了。这里我通常会选择全局安装,这样它就能在任何地方被调用:

如何使用Valet在Mac搭建PHP环境 MacOS下快速PHP站点部署方式
composer global require laravel/valet

安装完Valet的依赖后,还需要让Valet在你的系统里“安家落户”,配置Nginx和DnsMasq:

valet install

valet install 命令会做几件事:它会安装并配置Nginx、DnsMasq,并把它们设置为开机自启动的服务。DnsMasq负责将你本地的 .test 域名(默认后缀)解析到 127.0.0.1,这样你访问 your-project.test 就能指向本地站点了。Nginx则负责处理HTTP请求。

现在,你的Valet环境已经搭建好了。要部署一个PHP站点,你只需要进入你的项目目录,然后执行:

valet park

或者,如果你只想让某个特定目录作为站点根目录,而不是整个父目录下的所有子目录都变成站点,你可以用 valet link

cd ~/Sites/my-php-project
valet link my-php-project

这样,你就可以在浏览器里通过 http://my-php-project.test 访问你的项目了。我用它搭建过几十个WordPress站,那种丝滑感是MAMP、XAMPP这些大块头给不了的。

Valet与传统WAMP/LAMP/MAMP环境有何不同?

说实话,刚开始接触Valet的时候,我也好奇它跟MAMP、XAMPP这些老牌集成环境有什么本质区别。用了一段时间后,我发现它们的设计哲学完全不同。

MAMP、XAMPP这类工具,往往是“一站式”解决方案,它们通常会打包Apache、MySQL、PHP以及phpMyAdmin等,提供一个图形界面让你启动、停止服务,配置虚拟主机。这对于新手来说很友好,因为所有东西都在一个包里。但缺点也显而易见:它们通常比较臃肿,资源占用高,而且你可能并不需要所有这些组件。比如,如果你只做PHP开发,Apache可能就显得有些“重”了,Nginx在处理静态文件和并发连接方面往往更高效。

Valet则走的是“极简主义”路线。它不提供庞大的图形界面,完全基于命令行操作。它只专注于Web服务器(Nginx)、DNS解析(DnsMasq)和PHP运行环境(PHP FPM)。数据库呢?它不会帮你装,你可以单独安装MySQL或PostgreSQL,或者用Docker。这种“只做一件事,并把它做好”的理念,让Valet变得极其轻量和快速。

WowTo
WowTo

用AI建立视频知识库

下载

更关键的是,Valet的“零配置”特性。你不需要手动编辑Nginx配置文件来为每个项目设置虚拟主机。valet park 命令会把你指定的一个目录下的所有子目录都自动注册为可访问的站点(例如,~/Sites/project-a 会变成 project-a.test)。这种自动化的域名解析和站点服务,大大简化了多项目开发的管理。对我来说,这意味着我可以快速切换项目,不用每次都去配置一遍。

Valet在实际开发中可能遇到的常见问题及解决方案

Valet虽然好用,但在实际使用中,也偶尔会遇到一些小插曲。不过,好在它设计得比较健壮,大部分问题都有直接的解决方案。

一个比较常见的场景是,当你更新了PHP版本或者Valet自身时,服务可能会出现一些小毛病。比如,某个站点突然访问不了,或者PHP版本不对。这时候,我通常会先尝试最简单的“重启大法”:

valet restart

这个命令会重启Valet所管理的所有服务(Nginx、DnsMasq和PHP FPM),通常能解决大部分临时的配置或服务启动问题。

另一个经常遇到的问题是PHP版本切换。Mac上可能安装了多个PHP版本(比如PHP 7.4、8.0、8.1等)。Valet默认会使用Homebrew安装的最新PHP版本。但如果你的项目依赖特定PHP版本,或者你想在不同项目之间切换PHP版本,Valet提供了非常方便的命令:

valet use php@8.1 # 切换到PHP 8.1
valet use php@7.4 # 切换到PHP 7.4

这会全局切换Valet使用的PHP版本。如果你想某个特定项目使用不同的PHP版本,Valet目前没有直接的“按项目切换”功能,但你可以考虑使用phpbrewasdf这类更专业的PHP版本管理工具,或者通过Nginx配置来指定。不过,对于大多数场景,全局切换已经足够了。

有时候,你可能会遇到 .test 域名解析失败的情况。这通常是DnsMasq出了问题。你可以尝试运行 valet diagnose 来检查Valet的运行状态和配置,它会给出一些诊断信息,帮助你定位问题。如果问题依然存在,可以尝试卸载并重新安装Valet:

valet uninstall
composer global remove laravel/valet
# 确保删除 ~/.config/valet 目录
rm -rf ~/.config/valet
# 然后重新执行安装步骤
composer global require laravel/valet
valet install

这几乎是“万能药”,能解决大多数疑难杂症,因为它清除了所有旧的配置并重新构建。

Valet如何支持Laravel、WordPress等主流PHP框架和CMS?

Valet对主流PHP框架和CMS的支持,是我选择它的一个重要原因。它内置了多种“驱动”(drivers),能够自动识别项目类型并进行相应的配置,这省去了大量的手动调整。

当你把一个Laravel项目放到Valet管理的目录下(比如通过valet park),Valet会自动识别这是一个Laravel应用。你访问 your-laravel-project.test 时,Valet会智能地将请求路由到Laravel项目的public目录,并启动Laravel的请求生命周期。你不需要做任何额外配置,就像魔法一样。

对于WordPress也是如此。Valet有一个专门的WordPress驱动。当你把一个WordPress安装目录放到valet park的目录下,Valet就能识别它,并正确地处理WordPress的URL重写规则(比如漂亮的固定链接)。我经常用Valet来快速搭建临时的WordPress开发环境,进行主题或插件开发测试,效率非常高。

除了Laravel和WordPress,Valet还支持许多其他框架和CMS,包括Symfony、Zend Framework、Statamic、Jigsaw等等。这种开箱即用的兼容性,让开发者可以专注于代码本身,而不是环境配置。

从性能角度看,Valet由于其轻量级的设计,表现非常出色。Nginx作为Web服务器,在处理静态文件和高并发请求方面有着天然优势,而PHP FPM则能高效地管理PHP进程。这一切都在本地运行,资源占用极小,对于MacBook用户来说,这意味着更长的电池续航和更安静的风扇。我个人感觉,Valet在本地开发环境中的响应速度,比那些基于Apache的集成环境要快不少,尤其是在同时跑好几个项目的时候。它能自动启用HTTPS(通过 valet secure 命令),这对于本地开发需要模拟生产环境的HTTPS行为时,也提供了极大的便利。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2709

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1669

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1529

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

974

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1444

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1529

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

excel表格操作技巧大全 表格制作excel教程
excel表格操作技巧大全 表格制作excel教程

Excel表格操作的核心技巧在于 熟练使用快捷键、数据处理函数及视图工具,如Ctrl+C/V(复制粘贴)、Alt+=(自动求和)、条件格式、数据验证及数据透视表。掌握这些可大幅提升数据分析与办公效率,实现快速录入、查找、筛选和汇总。

0

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 9.1万人学习

Node.js 教程
Node.js 教程

共57课时 | 9万人学习

CSS3 教程
CSS3 教程

共18课时 | 4.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号