phpstudy部署laravel 10核心三步:1.php≥8.1并启用mbstring、openssl、pdo等扩展;2.网站根目录必须设为project/public;3.nginx用try_files $uri $uri/ /index.php?$query_string,apache默认.htaccess有效。

确保 PHP ≥ 8.1 且关键扩展已启用
Laravel 10 强制要求 PHP 8.1 或更高版本,并依赖 mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl 这些扩展。光看 php -v 不够,得确认它们真在运行。
- 打开 PHPStudy → “软件管理” → 找到 PHP 8.2.x(推荐 8.2.9)→ 点“安装”,再点“设为默认”
- 安装后点击该 PHP 版本右侧的“设置” → “PHP扩展” → 勾选上面列出的所有扩展(特别是 Windows 用户常缺 intl 和 opcache)
- 点“应用”重启 PHP,然后在命令行执行
php -m | findstr "mbstring openssl pdo"(Windows)或php -m | grep -E "mbstring|openssl|pdo"(macOS/Linux),确认每项都有输出
把网站根目录设为 project/public
Laravel 的入口文件是 public/index.php,不是项目根目录下的 index.php。如果 root 指向整个项目,.env 和 app/ 目录会暴露,且所有请求都 404 或直接下载 PHP 文件。
- 在 PHPStudy → “网站” → “添加网站”
- 域名填
myapp.test(或其他你喜欢的本地域名) - 网站目录填完整路径,例如:
D:\phpstudy_pro\WWW\myapp\public(注意结尾是 \public,不是 \myapp) - 保存后点“重启 Apache”或“重载服务”
- 验证:访问
http://myapp.test/.env应返回 404;访问http://myapp.test应显示 Laravel 欢迎页
配置 Nginx/Apache 伪静态规则
PHPStudy 默认用 Apache,但新版也支持 Nginx。无论哪种,都要让所有非静态资源请求都转发给 index.php 处理,否则路由全挂。
-
Apache 用户:无需额外配置 .htaccess —— Laravel 自带的
.htaccess在 public 目录下已生效,前提是 Apache 启用了mod_rewrite(PHPStudy 默认开启) -
Nginx 用户(如用 PHPStudy Pro):进网站设置 → “配置文件” → 切换到 nginx.conf 标签页 → 找到
location / { }块,替换为:location / { try_files $uri $uri/ /index.php?$query_string; } - 确保这段代码在
location ~ \.php$ { }块之前,删掉任何rewrite或if (!-e $request_filename)类旧规则 - 改完点“重载 Nginx”,不要只点“保存”
初始化项目与环境检查
项目本身要干净,.env 配置要准确,缓存要及时清空。
- 用 Composer 创建项目时加版本约束:
composer create-project laravel/laravel:^10.0 myapp - 进项目目录,运行
php artisan key:generate生成 APP_KEY - 编辑
.env:APP_URL 设为http://myapp.test(必须和你配的域名一致),DB_DATABASE 填数据库名(如laravel),DB_USERNAME 和 DB_PASSWORD 按 MySQL 设置填(默认 root + 空密码) - 执行
php artisan config:clear和php artisan cache:clear,避免旧缓存干扰 - 在 PHPStudy 中启动 MySQL,再用 phpMyAdmin 创建对应数据库
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











