PhpStudy中部署Laravel 10需三步:1.PHP≥8.1并启用mbstring、openssl、pdo等扩展;2.网站根目录设为project/public;3.Nginx用try_files规则,Apache默认.htaccess有效。

在PhpStudy中安装Laravel框架,关键不是“装Laravel”,而是让PhpStudy环境满足Laravel运行条件,并把项目正确接入Web服务器。整个过程围绕三件事:PHP版本和扩展达标、网站根目录指向public、伪静态规则生效。下面分步说明。
确认并配置PHP版本与扩展
Laravel 10要求PHP ≥ 8.1,且必须启用以下扩展:mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl、opcache(Windows用户尤其注意intl常被忽略)。
- 打开PhpStudy → “软件管理” → 安装并设为默认的PHP 8.2.x(如8.2.9),避免用7.x或过低8.x版本
- 点击该PHP版本右侧“设置” → “PHP扩展” → 全部勾选上述扩展 → 点“应用”并重启PHP
- 命令行执行:
php -m | findstr "mbstring openssl pdo intl"(Windows)或
php -m | grep -E "mbstring|openssl|pdo|intl"(macOS/Linux),确认每项有输出
创建Laravel项目并放入合适位置
不要直接把Laravel项目丢进WWW根目录,而应先用Composer生成,再整体部署。
- 打开命令行,进入你希望存放项目的文件夹(如
D:\myprojects) - 执行:
composer create-project laravel/laravel myapp
等待完成,生成myapp文件夹 - 将整个
myapp文件夹复制到PhpStudy网站根目录下(如D:\phpstudy_pro\WWW\),路径变为:
D:\phpstudy_pro\WWW\myapp\
添加网站并设置根目录为public
这是最容易出错的一步:入口必须是public子目录,否则.env可能暴露,路由全部失效。
立即学习“PHP免费学习笔记(深入)”;
- PhpStudy → “网站” → “添加网站”
- 域名填
myapp.test(或其他你喜欢的本地域名) - 网站目录填完整路径:
D:\phpstudy_pro\WWW\myapp\public(结尾是\public,不是\myapp) - 保存后点击“重启Apache”或“重载Nginx”
- 验证:
访问 http://myapp.test/.env 应返回404;
访问 http://myapp.test 应显示Laravel欢迎页
配置伪静态规则(按Web服务器类型)
确保所有请求(除真实静态文件外)都转发给index.php处理,否则/login等路由会404。
-
Apache用户:无需额外操作,Laravel自带的
.htaccess在public目录下已就绪,前提是PhpStudy已启用mod_rewrite(默认开启) -
Nginx用户:进网站设置 → “配置文件” → 切换到
nginx.conf标签页 → 找到location / { }块,替换为:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
确保这段在location ~ \.php$ { }之前,删掉旧的if (!-e $request_filename)等规则 → 点“重载Nginx”
初始化项目基础配置
首次访问前建议补全两件事,避免后续报错:
- 进入项目根目录(
D:\phpstudy_pro\WWW\myapp),执行:
php artisan key:generate
生成APP_KEY写入.env,保障加密安全 - 确保
storage和bootstrap/cache目录可写(Windows下右键→属性→安全→编辑权限,赋予当前用户“修改”权限;或用命令行:
icacls storage /grant Users:(OI)(CI)F
icacls bootstrap\cache /grant Users:(OI)(CI)F)


















