# 安装

# 步骤一：代码下载

运行环境要求 PHP Version：>= 7.2.5

# Git拉取（推荐）

安装执行如下命令：

git clone https://gitee.com/worklz/yunj-admin-tp6.git 项目名

仓库地址：gitee.com/worklz/yunj-admin-tp6.git (opens new window)

注意：不要轻易在项目根目录下执行git更新操作，避免业务代码丢失。

# Composer安装

Composer操作详见：Composer中文文档 (opens new window)

安装执行如下命令：

composer create-project yunj/admin-tp6 项目名

注意！由于镜像更新问题，composer可能不能及时获取最新的稳定版本。我们建议使用Git方式进行安装。

注意！安装提示镜像找不到的情况下，可设置composer镜像地址为：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 步骤二：配置完善

为了方便环境检测时快速通过，在执行命令安装前，请完善如下操作：

PHP 开启redis扩展

完善redis缓存通道配置，并开启redis服务

文件路径：项目根目录/config/cache.php

内容如下：

return [
    'stores'  => [
        'redis'   =>  [
            'type'   => 'redis',        // 驱动方式
            'host'   => '127.0.0.1',    // 服务器地址
            'password' => '******',     // 密码
            'prefix' => '******',       // 缓存前缀
            'expire' => 3600,           // 缓存有效期 0表示永久缓存
            ...
        ],...
    ],...
];

完整项目代码可通过配置：项目根目录/.env 即可

内容如下：

[REDIS]
HOST = 127.0.0.1
PASSWORD = 123456
PREFIX = yj.admin.tp6:
EXPIRE = 3600

创建MySql数据库、完善配置，并启用MySql服务

创建数据库：

CREATE DATABASE IF NOT EXISTS `数据库名` DEFAULT CHARACTER SET utf8mb4

完善数据库配置

文件路径：项目根目录/config/database.php

内容如下：

// 以下值为示例值，可根据需求自行更改
return [
  'default' => 'mysql',
  'connections' => [
    'mysql' => [
      'type' => 'mysql',            // 数据库类型
      'hostname' => '127.0.0.1',    // 服务器地址
      'database' => '数据库名',      // 数据库名
      'username' => '数据库用户名',  // 用户名
      'password' => '数据库密码',    // 密码
      'hostport' => '3306',         // 端口
      'charset' => 'utf8mb4',       // 数据库编码，建议和创建数据库时的编码保持一致
      'prefix' => 'yj_',            // 数据库表前缀
      ...
    ],...
  ],...
];

完整项目代码可通过配置：项目根目录/.env 即可

内容如下：

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = db_yunj_admin_tp6
USERNAME = db_yunj_admin_tp6
PASSWORD = 123456
HOSTPORT = 3306
CHARSET = utf8mb4
PREFIX = yj_
DEBUG = true

完善应用域名配置（可选）

文件路径：项目根目录/config/app.php

内容如下：
```
return [
  'app_host' => 'http://www.xxx.com',
  ...
];
```

完善应用初始化事件监听配置（完整项目代码可忽略此步骤）

文件路径：项目根目录/app/event.php

内容如下：

return [
    'listen'    => [
        'AppInit'  => [
            "yunj\core\Init",    // 云静Admin初始化处理
            ...
        ],...
    ],...
];

# 步骤三：命令安装

完善上诉操作后，进入项目根目录，执行如下命令进行环境初始化操作：

# 此处php为当前项目使用的php版本
php think yunj:init

命令运行示例：

使用命令运行后生成的登录地址、管理员账户、密码进行访问。若遗忘了账户可重复运行命令拿到新的账户密码，此账户密码在登录后台后可在个人信息里面修改。

首次访问会执行项目初始化操作，时间稍长为正常现象

注意！安装完成后，你可能需要为目录`项目根目录/runtime`、`项目根目录/public/upload`配置读写权限，允许 Web 服务器进行读写操作。

提示！在安装过程中，倘若遇到不可逆的运行错误，可通过重新执行命令来重置项目。

更新 →