0

0

composer安装Yii2框架教程_高级版/基础版安装与配置【实操】

尼克

尼克

发布时间:2026-01-04 17:28:02

|

804人浏览过

|

来源于php中文网

原创

yii2基础版和高级版是两个独立项目骨架,命令、目录结构、启动方式均不同:基础版用composer create-project --prefer-dist yiisoft/yii2-app-basic basic,单入口web/;高级版用composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced,需执行php init并配置前后端document_root。

composer安装yii2框架教程_高级版/基础版安装与配置【实操】

直接用 composer create-project 装 Yii2,高级版和基础版不是“选模板”,而是两个独立项目骨架,命令不同、目录结构不同、启动方式也不同——装错一个,后续路由、入口文件、配置加载全会出问题。

基础版安装:适合快速验证或轻量后端 API

基础版只有一个 web/ 入口目录,index.php 直接在根下,没有前后端分离的 frontend/backend 结构。它默认不带 Gii、用户登录等模块,更干净。

执行命令:

WOC-YII开源站群管理系统1.3
WOC-YII开源站群管理系统1.3

WOC-YII是rschome.com基于yii framework 1.1.8框架所开发的一款开源简易站群管理系统。它的功能与WOC完全一样。目前版本为V1.3,新版本正在开发中,同时欢迎大家参与到开发中来! WOC-YII 1.3在1.2的基础上优化了登录系统(密码加密),优化了权限控制系统,新增seo管理功能,新增自动安装向导! 程序框架:yiiframework1.1.8 配置文件:p

下载
composer create-project --prefer-dist yiisoft/yii2-app-basic basic

注意点:

  • yiisoft/yii2-app-basic 是官方包名,别写成 yii2-basic 或漏掉 yiisoft/ 命名空间
  • 安装后进 basic/ 目录,用 php yii serve 启动(PHP 7.4+ 内置服务器),别直接跑 web/index.php —— 因为没配 Web 服务器重写规则时,index.php 无法正确解析路由
  • 数据库配置在 config/db.php,不是 main-local.php

高级版安装:适合中大型项目,含前后端分离结构

高级版自带 frontendbackend 两个应用,共用 common 层,console 支持命令行任务。但它的入口路径更绕,web/ 不在项目根目录,而是在 frontend/web/backend/web/ 下。

执行命令:

composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced

关键后续操作:

  • 必须先运行 init:进入 advanced/ 目录后执行 php init,选 Development 模式,它会生成 environments/ 下的配置并软链到 frontend/web/backend/web/ 等位置
  • 没跑 init 就直接访问 frontend/web/index.php,大概率报错 Class 'Yii' not foundInvalid Parameter – yii\base\InvalidParamException
  • frontend/web/backend/web/index.php 都要单独配置 Web 服务器的 DOCUMENT_ROOT,不能把整个 advanced/ 当根目录

常见错误:composer 安装卡住或报错

Yii2 依赖多,国内直连 Packagist 经常超时或 404。别硬等,优先换源:

  • 全局换阿里云镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
  • 如果提示 failed to open stream: php_network_getaddresses: getaddrinfo failed,说明 DNS 解析失败,不是网络不通,换源后重试即可
  • 遇到 require yisoft/yii2 ~2.0.46 报冲突?检查是否本地已装过其他 Yii2 项目并锁定了旧版本,删掉 composer.lockvendor/ 后重装
  • PHP 版本低于 7.4 会直接失败——Yii2.0.x 最低要求 PHP 7.4,php -v 必须确认清楚

装完第一件事:验证 autoloader 和入口路径

不管基础版还是高级版,只要看到 Class 'Yii' not found,90% 是因为 vendor/autoload.php 没被正确引入,或 index.php 找不到 Yii::createWebApplication() 所需的配置路径。

快速自查:

  • 打开 web/index.php(基础版)或 frontend/web/index.php(高级版),确认第 13 行左右有:require __DIR__ . '/../vendor/autoload.php';
  • 确认 ../vendor/ 路径真实存在且可读;高级版里这个 .. 是从 web/ 往上一级,指向的是 frontend/ 目录,不是项目根目录
  • 基础版的 config/web.php 在根目录下;高级版的对应文件在 environments/dev/frontend/config/main-local.phpinit 后才生效

路径差一级,整个应用就起不来。别跳过 ls -la 看一眼 vendor 和 config 是否真在预期位置。

热门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

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

506

2023.11.27

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

747

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

24

2025.12.06

console接口是干嘛的
console接口是干嘛的

console接口是一种用于在计算机命令行或浏览器开发工具中输出信息的工具,提供了一种简单的方式来记录和查看应用程序的输出结果和调试信息。本专题为大家提供console接口相关的各种文章、以及下载和课程。

419

2023.08.08

console.log是什么
console.log是什么

console.log 是 javascript 函数,用于在浏览器控制台中输出信息,便于调试和故障排除。想了解更多console.log的相关内容,可以阅读本专题下面的文章。

534

2024.05.29

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

380

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2105

2023.08.14

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

3

2026.03.03

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

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

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