0

0

Yii2.0框架在宝塔面板安装_一键部署与站点配置【指南】

雪夜

雪夜

发布时间:2026-03-11 19:18:13

|

614人浏览过

|

来源于php中文网

原创

yii2在宝塔运行不报500错误的关键是将站点根目录设为/web子目录(如/www/wwwroot/your-site/web),确保web/index.php可读、php版本≥7.4,并正确配置nginx伪静态规则。

yii2.0框架在宝塔面板安装_一键部署与站点配置【指南】

Yii2.0 怎么在宝塔里跑起来不报 500 错误

直接原因通常是 web 目录没设对,或者 index.php 没被正确识别为入口。宝塔默认把站点根目录指向 /www/wwwroot/xxx,但 Yii2 要求 Web 服务器只暴露 web/ 子目录,否则 config/runtime/ 这些敏感路径可能被直接访问。

实操建议:

  • 在宝塔「网站」→「添加站点」时,根目录填 /www/wwwroot/your-site/web(不是项目根目录)
  • 确认 web/index.php 文件存在且可读,PHP 版本选 7.4 或 8.0+(Yii2.0 官方最低要求 PHP 5.6,但实际用 7.2+ 更稳)
  • 如果用 Nginx,宝塔会自动套用 PHP 站点模板,但需检查伪静态是否启用——Yii2 不强制需要 URL 重写,但开启后 urlManager 才能隐藏 index.php
  • 常见错误现象:500 Internal Server Error 且日志里出现 require(): Failed opening required '/www/wwwroot/your-site/requirements.php',说明入口文件加载了错误的相对路径,根源还是根目录设高了一级

宝塔里怎么配 Yii2 的 rewrite 规则(Nginx)

不是所有场景都需要重写,但想用干净 URL(比如 /site/login 而非 /index.php?r=site%2Flogin),就得让 Nginx 把请求兜给 index.php 处理。

实操建议:

  • 在宝塔站点设置 → 「伪静态」选项卡,选择「Laravel5」模板(它和 Yii2 的重写逻辑一致),或手动粘贴以下规则:
location / {
    try_files $uri $uri/ /index.php?$args;
}

注意:别用 Apache 的 .htaccess 内容直接贴过来,Nginx 不认;也别加 if (!-e $request_filename) 这类冗余判断,容易引发 404 或循环重定向。

皮卡智能
皮卡智能

AI驱动高效视觉设计平台

下载
  • 改完记得「重载配置」,否则不生效
  • 如果启用了 urlManager['enablePrettyUrl'] = true 却仍跳转到 index.php,先检查 web.phpshowScriptName 是否设为 false

runtime 和 assets 目录权限总被宝塔“重置”怎么办

宝塔后台点「一键部署」或「重启 PHP」时,有时会顺手把整个站点目录 chown 成 www:www,但 Yii2 的 runtimeassets 必须可写,而 www 用户不一定有权限写入子目录(尤其当项目是 git clone 下来、属主是 root 时)。

实操建议:

  • 进 SSH,执行:chown -R www:www /www/wwwroot/your-site/runtimechown -R www:www /www/wwwroot/your-site/web/assets
  • 别给整个项目目录 777——宝塔的「文件管理器」里右键设权限,仅对这两个目录设 755 或 775 即可
  • 如果部署后首次访问报 Failed to write file to diskUnable to write to directory,基本就是这个原因
  • 额外提醒:runtime 目录下 logscache 是运行时生成的,如果权限不对,连错误日志都写不进去,排查会更困难

用宝塔「一键部署」装 Yii2 为什么经常失败

宝塔官方应用市场里的「Yii2」安装包,本质是打包了一个基础骨架(通常是 basic 模板),但它不处理 Composer 依赖、不校验 PHP 扩展(如 mbstringgdopenssl),也不适配你自己的数据库配置。

实操建议:

  • 放弃「一键部署」按钮,改用「手动上传」或「Git 克隆」:把已本地调试好的完整项目(含 vendor)传上去,或在宝塔终端里 cd 到站点目录后运行 composer install --no-dev
  • 务必提前检查 PHP 扩展:在宝塔「软件商店」→「PHP 设置」→「配置文件」里确认 extension=mbstring.so 等已取消注释
  • 数据库配置别写死在 common/config/main-local.php 里再传——用宝塔「网站」→「配置文件」功能,在 web/index.php 上方加环境变量,或通过 $_SERVER 注入,避免配置泄露

最麻烦的其实是开发环境和生产环境的差异:本地用 localhost,上线得换 127.0.0.1;本地关了 debug,线上忘了关导致敏感信息暴露。这些细节不会被一键脚本覆盖,得自己盯住。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2023.12.25

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

246

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

522

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

610

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

693

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3618

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

54

2026.01.13

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

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