README

• 说明

• 项目部署

  • PHP配置

  • 安装第三方扩展和创建数据库表

  • 服务器配置

  • 使用

• 结构说明

  • 文件和目录

  • Model

  • Layout

• 打赏

说明

这是我2016年在空闲时间用 yii2-basic 模板来练手的东西，里面的代码不一定能在实际工作中使用，也不一定是最好的写法，而且年代久远，仅供参考，我只会时不时上来更新一下 composer 测试一下有没有问题再去公司的项目里更新，新功能估计不会再搞。

目前可能是你能学到一点破姿势的地方：

前台文章首页（/frontend/article/index）：使用 ActiveDataProvider 遍历数据、分页、排序（虽然很基础，但比起传统的手动加 offset、limit、order by 还得算总数方便多了）。

个人中心（/user/home）：这里的页面加载你看起来感觉会很快，因为我用了 pjax，不过目前有个 bug，点击链接时我会把链接的文字加到右边面板上，但是后退的时候就尴尬了，我现在有两个方案，但还懒得去改。

另外，有些东西我封装到这个项目里了，具体作用去看说明和我给出的 demo 吧。

项目部署

PHP配置

扩展：openssl、pdo_mysql、fileinfo

程序上的上传文件大小限制在 app\models\Music::MUSIC_SIZE，我随便设置了一个 20MB，php 的 post_max_size 和 upload_max_filesize 两个值需要配置一下。

安装 composer 依赖（vendor 目录）

首先你要有 composer，然后按顺序执行以下命令，如果你觉得速度慢的话，可以参考我的这篇文章。

composer self-update
composer install --prefer-dist

生成本地配置文件

php init --env=Development --overwrite=all

创建数据库表

在 MySql 创建一个 utf8 数据库，在 config/db.php 文件配置好之后，按顺序执行以下命令：

php yii migrate

服务器配置

直接参考官方文档，我的 nginx 配置就是直接抄官方文档里面的。

nginx 也看看这篇文章。

使用

在 config/components-local.php 里找到邮箱的配置，配置好了才能用找回密码的功能。

已经生成好的用户名和密码如下：

结构说明

完成上面的步骤后你就可以使用了，如果你想了解我的项目的话，可以看看这一节。

我的代码是从 gii 生成的 model 和 CRUD 代码上修改而来的，如果你也是这个套路的话，那我的代码应该还算容易看懂，就 model 和原来的有些区别，详情请往下拉。

文件和目录

没列出的文件随便看看就好。

common                    一些我自己封装的代码和改写的类

config
├ components.php          组件配置
├ components-local.php    本地组件配置，在 environments 里通过 init 生成
├ db.php                  数据库配置，在 environments 里通过 init 生成
├ modules.php             模块配置
└ web.php                 框架配置

models                    放 model 的地方，下面有详细说明

modules
├ backend                 后台模块
├ frontend                前台模块
└ user                    用户相关，例如登入登出、个人中心、找回密码等

views                     放布局文件和错误页面用，下面有详细说明

models 目录

我用 gii 生成 model 到 models/base 目录下，取名为 'ModelBase'，然后在 models 目录下新建一个 'Model' 来继承 'ModelBase'，以后只编辑 'Model'，这样做的好处是重新生成 model 可以直接覆盖。

用 gii 生成 crud 代码，其中有一项 “Search Model Class”，我把它生成到 models/search 目录下。

views/layout 目录

布局结构和说明：

base_html5.php         最外层，最基础的 html 结构，所有人都能用，layout 不直接指向这里
└ master.php           根据自己项目自定义的最外层，layout 不直接指向这里
  ├ frontend.php       前台外层，layout 不直接指向这里
  │ ├ main.php         前台，框架默认指向的地方
  │ ├ user.php         用户模块
  │ └ user_form.php    用户模块的表单
  └ backend.php        后台

layout 会统一在 config/modules.php 里配置，frontend 模块里两个控制器的 beforeAction() 方法里也有修改布局的代码。

只做输出用的文件，在同级的 include 目录下：

layout/frontend.php
└ include/frontend_nav.php    顶部 bootstrap 的菜单

layout/backend.php
├ include/backend_menu.php    左侧菜单
└ include/bacnend_nav.php     顶部 bootstrap 的菜单

打赏

如果觉得我做的东西对你有帮助的话，求打赏一杯 coffee，这样我会有更多动力去分享更多 yii2 的内容。