安装部署

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

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

运行环境检查

  • 执行 php -v,是否可以看到 PHP 的版本信息?
  • 执行 composer -v 是否可以看到 Composer 的版本信息?
  • 执行 composer self-updateComposer 更新到最新版本!
$ 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,在 LinuxMacOS 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 用户)或控制台( LinuxMac 用户)并执行如下命令:

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. 通过源码安装:( 默认安装 adminwechat 两个模块 )

如果需要安装演示系统的旧版本 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

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

数据库配置及安装

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

注意:数据库参数修改,除了要修改连接参数,还需要切换 default 默认连接名称,如下面的 mysqlsqlite 等。

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 官方的文档,建议使用 宝塔面板 管理服务器。

  • 宝塔集成环境,直接选择 MVCThinkPHP 默认规则

  • Apache 服务器配置
  • httpd.conf 配置文件中加载了mod_rewrite.so模块
  • AllowOverride NoneNone改为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>
Last Updated:
Contributors: 邹景立