安装部署

ThinkAdmin 是基于 ThinkPHP6 开发的极简后台管理框架，需要运行在不低于 PHP7.1 的环境中，其依赖是基于 Composer 管理，还需要安装 Composer 包管理工具；另外数据库默认已支持 Sqlite、MySql、SqlServer 三种数据库，使用其他数据库需要另外针对性处理。

温馨提示：ThinkAdmin 已经全面兼容 ThinkPHP8 框架，在 PHP8 环境执行 Composer update 指令会自动升级为 ThinkPHP8 框架，在开发系统时尽量按照 ThinkPHP 标准编写代码，以防止无法正常升级核心框架。在使用 ThinkAdmin 开发时，保留原系统 PaaS 模块可升级性非常有必要，官方会不定时发布插件更新以更新或修补系统漏洞，另外 admin 模块不存在不可修改的显示内容，完全可以通过修改参数来达到个性化显示，没必要重构它来自定义显示一些内容。

运行环境检查

执行 php -v，是否可以看到 PHP 的版本信息？
执行 composer -v 是否可以看到 Composer 的版本信息？
执行 composer self-update 将 Composer 更新到最新版本！

$ php -v
# 执行 php -v 结果如下为 PHP 8.1.10
> PHP 8.1.10 (cli) (built: Aug 30 2022 18:08:04) (NTS Visual C++ 2019 x64)
> Copyright (c) The PHP Group
> Zend Engine v4.1.10, Copyright (c) Zend Technologies

如果还没有安装 Composer，在 Linux 和 MacOS X 中可以运行如下命令：

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

在 Windows 中，你需要下载 Composer-Setup.exe，并运行程序进行安装操作。

如果遇到任何问题或者想更深入地学习 Composer，请参考 Composer 文档（英文文档，中文文档）。

温馨提示： 目前国内大部分 composer 代理镜像不全，使用以下命令移除代理。

// 移除代理镜像
composer config -g --unset repos.packagist

系统下载及安装

下载并进入 ThinkAdmin 目录，运行指令安装依赖组件。

打开命令行窗口（ Windows 用户）或控制台（ Linux 的 Mac 用户）并执行如下命令：

1. 通过 Composer 安装： ( 推荐方式，默认只安装 admin 模块 )

### 创建项目（ 需要在英文目录下面执行 ）
composer create-project zoujingli/thinkadmin

### 进入项目根目录
cd thinkadmin

### 数据库初始化并安装 
### 默认使用 Sqlite 数据库，若使用其他数据库请修改配置后再执行
php think migrate:run

### 安装微信管理模块
composer require zoujingli/think-plugs-wechat

### 开启PHP内置WEB服务
### 默认后台登录账号及密码都是 admin
php think run --host 127.0.0.1

2. 通过源码安装：（默认安装 admin、wechat 两个模块）

如果需要安装演示系统的旧版本 data 模块代码，请跳转到 https://gitee.com/zoujingli/think-plugs-data

### 下载项目（ 需要在英文目录下面执行 ）
# git clone https://github.com/zoujingli/ThinkAdmin
git clone https://gitee.com/zoujingli/ThinkAdmin

### 进入项目根目录
cd ThinkAdmin

### 安装项目依赖组件
composer install --optimize-autoloader

### 数据库初始化并安装
### 默认使用 Sqlite 数据库，若使用其他数据库请修改配置后再执行
php think migrate:run

### 开启PHP内置WEB服务
### 默认后台登录账号及密码都是 admin
php think run --host 127.0.0.1

如果希望安装其他插件，可以跳转到插件生态查看详情。

数据库配置及安装

创建空的数据库，其中 Sqlite 不需要创建；
将数据库配置到 config/database.php 文件；

注意：数据库参数修改，除了要修改连接参数，还需要切换 default 默认连接名称，如下面的 mysql、sqlite 等。

return [
     // 数据库类型
    'default' => 'sqlite',
    // 数据库连接参数
    'connections' => [
        'mysql'  => [ /* 具体参数省略 */ ], 
        'sqlite' => [ /* 具体参数省略 */ ],
    ]       
]

当前版本是 ThinkAdmin v6.1 ，不需要导入数据库 SQL 脚本，修改数据库配置后执行 php think migrate:run 即可；

注意：如果希望在 PgSQL 上运行，需要先将数据库安装到 MySQL 再使用工具同步到 PgSQL，再配置数据表 ID 主键自增。

运行 PHP 内置服务

本地开发可以直接使用 php -S 内置服务器，不需要配置完整的 Web 服务。

方式 1.>$ php think run // 以 debug 方式运行（会显示 CMD 界面及加载日志）
方式 2.>$ php think xadmin:queue webstart // 以 daemon 方式运行（不会显示 CMD 界面）
浏览器访问 http://127.0.0.1:8000 // 可以使用 --port 端口号 指定服务端口号

默认账号及初始化

系统默认是没有配置文件存储规则，无法上传文件，需要进入后台配置。

1.登录并进入后台，默认账号及密码都为：admin
2.进入后台系统管理->系统参数配置，修改文件上传参数并保存。
3.初始化后建议修改系统参数，如：网站名称，版权信息，网站备案号等。

线上生产环境部署

生产环境部署参考 ThinkPHP 官方的文档，建议使用宝塔面板管理服务器。

宝塔集成环境，直接选择 MVC 或 ThinkPHP 默认规则

Apache 服务器配置

httpd.conf 配置文件中加载了mod_rewrite.so模块
AllowOverride None将None改为All
把下面的内容保存为.htaccess文件放到应用入口文件的同级目录下

<IfModule mod_rewrite.c>
    Options +FollowSymlinks -Multiviews
    RewriteEngine On

    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

Nginx 服务器配置

if (!-e $request_filename) {
    rewrite ^(.*)$ /index.php$1 last;
}

IIS 服务器管理

如果你的服务器环境支持ISAPI_Rewrite的话，可以配置httpd.ini文件，添加下面的内容：RewriteRule (.*)$ /index\.php\?s=$1 [I]
在IIS的高版本下面可以配置web.Config，在中间添加rewrite节点：


<rewrite>
    <rules>
        <rule name="OrgPage" stopProcessing="true">
            <match url="^(.*)$"/>
            <conditions logicalGrouping="MatchAll">
                <add input="{HTTP_HOST}" pattern="^(.*)$"/>
                <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
                <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
            </conditions>
            <action type="Rewrite" url="index.php/{R:1}"/>
        </rule>
    </rules>
</rewrite>

# 安装部署

# 运行环境检查

# 系统下载及安装

# 数据库配置及安装

# 运行 PHP 内置服务

# 默认账号及初始化