yii# 项目环境需求

linux 或 windows
apache2.4|nginx
mysql5.6    数据库使用 utf8mb4_unicode_ci 字符集
php5.6

# # #

项目部署（svn checkout后即可）

1 解压 vendor.zip 到sa目录

目录参考

根目录/
    common/                 公共模块
    console/                控制台模块
    data/                   存放数据的目录，如上传的文件
    erp/                    erp web 模块
    backend/                后台 web 模块（目前没用）
    frontend/               前端 web 模块（目前没用）
    vendor/                 【解压后的目录】composer 管理工具软件包存放目录
    environments/           环境配置目录

2 初始化 yii 项目

生成本地开发或生产环境所需的特殊配置

./sa/ 目录下执行命令

php init

3 初始化数据库

执行 php init 后，会生成 common/config/main-local.php

3.1 在本地 mysql 上手动创建一个数据库

注意：数据库字符集必须是 utf8mb4_unicode_ci 否则可能导致数据库乱码

3.2 修改配置配置文件

打开 common/config/main-local.php 修改数据库相关的配置

'db' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=数据库名',
    'username' => '数据库账号',
    'password' => '数据库密码',
    'charset' => 'utf8',
],

3.3 数据库初始化

3.3.1 手动执行带有部分数据的原始sql

/console/migrations/sql/base_sql_data.sql

3.3.2 执行数据库迁移操作

根目录下执行命令

yii migrate
或
./yii migrate       # 如果提示找不到 yii 命令，可输入这条命令

4 配置 apache 支持漂亮的 url（pretty URL）

4.1 打开 apache 配置文件

配置文件参考路径： apache2.4.33/conf/httpd.conf 或 apache2.4.33/conf/extra/httpd-vhosts.conf

在配置文件中找个位置填入一下内容（注意修改一些路径信息）

<VirtualHost *:80>
    # 需要修改：本地虚拟域名（注意修改hosts文件）
    ServerName erp.local
    ServerAlias erp.local
    DocumentRoot "C:/wamp64/www/project/erp"
    
    # 需要修改：项目根路径的地址
    <Directory "C:/wamp64/www/project/erp">
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
        DirectoryIndex index.php
    </Directory>
</VirtualHost>

注意：如果配置后，其他网站无法运行，请加上如下配置：

<VirtualHost *:80>
  ServerName localhost
  ServerAlias localhost
  DocumentRoot "${INSTALL_DIR}/www"
  <Directory "${INSTALL_DIR}/www/">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require local
  </Directory>
</VirtualHost>

<VirtualHost *:80>
  ServerName 127.0.0.1
  ServerAlias 127.0.0.1
  DocumentRoot "${INSTALL_DIR}/www"
  <Directory "${INSTALL_DIR}/www/">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require local
  </Directory>
</VirtualHost>

4.2 重启 apache 服务器

5 查看是否正常访问

5.1 在浏览器输入：http://虚拟域名/erp/web/index.php

如果没有出现 404 错误，证明可正常访问

# # #

文件目录说明

common              公共模块
    config/             公共配置
    constant/           常量
    models/             数据模型目录
        db/                 数据表模型
        dbVo/               数据表字段内存放json数据的数据模型
        vo/                 数据模型
    traits/             Trait
    utils/              系统通用工具
    
console             控制台模块
    config/             控制台配置（覆盖 公共配置）
    controllers/        控制台控制器存放目录。用于执行命令行命令（可用作定时任务）
    migrations/         数据库版本管理文件存放目录
    models/             控制台所需 Model 目录
    runtime/            控制台运行时产生的文件。包括日志
    
data                存放数据的目录，如上传的文件
    
erp                 系统web模块
    assets/             资源管理
    config/             配置目录（覆盖 公共配置）
    controllers/        控制器目录
    models/             web 所需 Model 目录
    runtime/            web 模块运行时产生的文件
    service/            连接控制器和数据库操作的中间层
    utils/              erp相关工具
    views/              html 模板目录
    web/                信息服务器（如apache）直接访问的目录
    
vendor/             composer 管理工具软件包存放目录

environments/       环境配置目录

# # #

参考链接

• 初始化项目
• Gii自动代码生成配置
• v-charts
• vue.js
• PhpSpreadsheet
• PhpSpreadsheet中文参考

数据库命令参考

更新数据

yii migrate 或 yii migrate/up

数据库 回滚（降级）一个版本

yii migrate/down

添加数据库更新文件

yii migrate/create [文件名]

如：

yii migrate/create create_post

直接插入数据库更新文件例子

yii migrate/create create_post –fields=”title:string(12):notNull:unique,body:text”

IDE 插件

必装

插件名字	说明
Yii2 Support	提供yii相关的代码提示
Vue.js	提供vue相关的代码提示和代码识别
element	提供element-ui框架相关的组件名提示，以及部分文档

可选

插件名字	说明
CodeGlance	编辑器滚动条小地图

常用正则表达式

对象属性转label

如：

/**
 * @var int 名字
 */
public $name;

转为：

"name" => "名字",

search:

[ ]+/\*\*\n\s+\*\s{1,1}@var\s[a-zA-Z0-9\[\]]+\s(.+)\n\s+\*/\n\s+public \$([a-zA-Z0-9]+);\n

replace:

"$2" => "$1",\n