快速入门 FastAdmin 的开发环境搭建

一、环境要求

在开始搭建 FastAdmin 开发环境之前，需要确保您的系统满足以下基本要求：

1.1 PHP 版本要求

• PHP 7.1 及以上版本（推荐 PHP 7.4 或 8.0）
• 必须开启的 PHP 扩展：
  • PDO
  • MBstring
  • Tokenizer
  • XML
  • Ctype
  • JSON
  • Fileinfo
  • OpenSSL
  • CURL

1.2 数据库要求

• MySQL 5.5 及以上版本（需支持 InnoDB 引擎）
• 推荐 MySQL 5.7 或 8.0

1.3 Web 服务器

• Apache 或 Nginx（需支持伪静态）
• 推荐使用 Nginx

1.4 其他工具

• Composer（PHP 依赖管理工具）
• Git（可选，用于版本控制）
• Node.js（可选，用于安装 Bower 和 LESS）
• Bower（可选，用于管理前端资源）
• Less（可选，用于编辑 less 文件）

二、环境准备

2.1 安装 PHP

Windows 环境

1. 访问 PHP 官网（https://www.php.net/downloads.php）下载适合的版本
2. 解压到指定目录（如 C:\php）
3. 将 PHP 目录添加到系统环境变量 PATH 中
4. 验证安装：打开命令行，输入 php -v，显示版本信息即成功

Linux 环境（Ubuntu/Debian）

# 更新包列表
sudo apt update

# 安装 PHP 及必要扩展
sudo apt install php php-cli php-fpm php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath

# 验证安装
php -v

2.2 安装 MySQL

Windows 环境

1. 访问 MySQL 官网下载安装包
2. 按照向导完成安装
3. 记住 root 用户的密码

Linux 环境

# 安装 MySQL
sudo apt install mysql-server

# 启动 MySQL 服务
sudo systemctl start mysql

# 设置开机自启
sudo systemctl enable mysql

# 安全配置
sudo mysql_secure_installation

2.3 安装 Composer

Windows 环境

# 下载 Composer 安装脚本
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# 验证安装脚本
php -r "if (hash_file('sha384', 'composer-setup.php') === 'your_hash_here') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

# 安装 Composer
php composer-setup.php

# 删除安装脚本
php -r "unlink('composer-setup.php');"

# 将 Composer 移动到全局目录
mv composer.phar /usr/local/bin/composer

Linux 环境

# 下载并安装 Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# 验证安装
composer --version

2.4 安装 Web 服务器

安装 Nginx（推荐）

# Ubuntu/Debian
sudo apt install nginx

# 启动 Nginx
sudo systemctl start nginx

# 设置开机自启
sudo systemctl enable nginx

安装 Apache

# Ubuntu/Debian
sudo apt install apache2

# 启动 Apache
sudo systemctl start apache2

# 设置开机自启
sudo systemctl enable apache2

三、FastAdmin 安装

3.1 下载 FastAdmin

方式一：使用 Composer 安装（推荐）

# 创建新项目
composer create-project fastadmin/fastadmin myproject

# 进入项目目录
cd myproject

方式二：使用 Git 克隆

# 克隆项目
git clone https://gitee.com/karson/fastadmin.git

# 进入项目目录
cd fastadmin

# 安装前端依赖
bower install

# 安装 PHP 依赖
composer install

方式三：下载完整包

1. 访问 FastAdmin 官网（https://www.fastadmin.net/download.html）
2. 下载完整安装包
3. 解压到 Web 服务器目录

3.2 配置数据库

创建数据库

-- 创建数据库
CREATE DATABASE fastadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 创建用户（可选）
CREATE USER 'fastadmin'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON fastadmin.* TO 'fastadmin'@'localhost';
FLUSH PRIVILEGES;

修改数据库配置文件

编辑 application/database.php文件：

return [
    'type'            => 'mysql',
    'hostname'        => '127.0.0.1',
    'database'        => 'fastadmin',
    'username'        => 'root',
    'password'        => 'your_password',
    'hostport'        => '3306',
    'charset'         => 'utf8',
    'prefix'          => 'fa_',
    'debug'           => true,
    'deploy'          => 0,
    'rw_separate'     => false,
    'master_num'      => 1,
    'slave_num'       => 1,
    'fields_strict'   => true,
    'resultset_type'  => 'array',
    'auto_timestamp'  => false,
    'datetime_format' => false,
    'sql_explain'     => false,
];

3.3 配置 Web 服务器

Nginx 配置

编辑 Nginx 配置文件（通常位于 /etc/nginx/sites-available/default）：

server {
    listen 80;
    server_name fastadmin.local;
    root /path/to/fastadmin/public;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?s=$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.ht {
        deny all;
    }
}

Apache 配置

确保 Apache 的 mod_rewrite模块已启用，然后在项目根目录创建或修改 .htaccess文件：

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

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

3.4 安装向导

1. 在浏览器中访问 http://your-domain.com/install.php
2. 按照提示填写数据库信息和管理员账号
3. 点击”安装”按钮完成安装

命令行安装（推荐）

# 一键创建数据库并导入数据
php think install -u root -p your_password

安装完成后，后台访问地址为 http://your-domain.com/admin，默认账号为 admin，默认密码为 123456。

四、PhpStorm 开发环境配置

4.1 安装 PhpStorm

1. 访问 JetBrains 官网下载 PhpStorm
2. 按照向导完成安装
3. 激活试用版或购买许可证

4.2 配置 PHP 解释器

1. 打开 PhpStorm，点击菜单栏的 File→ Settings
2. 选择 Languages & Frameworks→ PHP
3. 点击 CLI Interpreter 右侧的 ...按钮
4. 选择 Add→ Local
5. 浏览并选择 PHP 可执行文件路径（如 C:\php\php.exe）
6. 点击 OK保存设置

4.3 配置项目

1. 打开 PhpStorm，选择 File→ Open
2. 选择 FastAdmin 项目目录
3. 等待 PhpStorm 索引完成
4. 设置项目解释器：File→ Settings→ PHP，选择刚才配置的解释器

4.4 配置调试环境

1. 安装 Xdebug 扩展
2. 在 PhpStorm 中，导航至 Settings→ PHP→ Debug
3. 配置 Xdebug 端口（默认 9003）
4. 设置路径映射

4.5 配置服务器

1. 点击菜单栏的 Run→ Edit Configurations
2. 点击 +按钮，选择 PHP Web Application
3. 设置服务器配置：
   • Name: FastAdmin
   • Server: 选择或创建服务器
   • Start URL: /
   • Browser: 选择默认浏览器
4. 点击 OK保存

五、常见问题及解决方案

5.1 安装问题

问题：Composer 安装失败

解决方案：

# 使用国内镜像
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 清除缓存
composer clear-cache

# 重新安装
composer install

问题：权限不足

解决方案：

# Linux 系统
chmod -R 755 runtime
chmod -R 755 public/uploads
chmod -R 755 application/database.php

问题：数据库连接失败

解决方案：

1. 检查 MySQL 服务是否启动
2. 确认数据库用户名和密码正确
3. 检查数据库是否存在

5.2 伪静态配置问题

问题：404 错误

解决方案：

• Nginx：检查 rewrite 模块是否启用
• Apache：检查 .htaccess 文件权限
• 确认根目录指向 public 文件夹

问题：500 错误

解决方案：

1. 检查 PHP 错误日志
2. 确认 PHP 扩展已安装
3. 检查数据库连接配置

5.3 其他常见问题

问题：页面样式不显示

解决方案：

1. 检查静态资源路径是否正确
2. 确认 Nginx/Apache 配置正确
3. 清除浏览器缓存

问题：后台无法访问

解决方案：

1. 检查伪静态配置
2. 确认数据库连接正常
3. 删除 config/install.lock文件重新安装

六、生产环境优化

6.1 安全加固

修改后台路径

// 修改 application/config.php
'admin_path' => 'your_custom_admin_path',

强制 HTTPS

# Nginx 配置
server {
    listen 80;
    server_name your_domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name your_domain.com;
    
    ssl_certificate /path/to/ssl/cert.pem;
    ssl_certificate_key /path/to/ssl/key.pem;
    
    # 其他配置...
}

6.2 性能优化

启用 OPcache

; php.ini 配置
[opcache]
opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.revalidate_freq=60

配置缓存

// 修改 application/config.php
'cache' => [
    'type' => 'file',
    'path' => CACHE_PATH,
    'prefix' => '',
    'expire' => 0,
],

6.3 日志配置

开启错误日志

// 修改 application/config.php
'app_debug' => false,
'app_trace' => false,
'log' => [
    'type' => 'file',
    'path' => LOG_PATH,
    'level' => ['error', 'sql'],
],

七、快速开发示例

7.1 创建 CRUD

创建数据表

CREATE TABLE `fa_test` (
  `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
  `title` varchar(100) NOT NULL DEFAULT '',
  `content` text NOT NULL,
  `createtime` int(10) UNSIGNED NOT NULL DEFAULT '0',
  `updatetime` int(10) UNSIGNED NOT NULL DEFAULT '0',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

一键生成 CRUD

# 生成 test 表的 CRUD
php think crud -t test

# 生成权限菜单
php think menu -c test

7.2 自定义控制器

创建控制器

<?php
namespace app\admin\controller;

use app\admin\library\Backend;

class Test extends Backend
{
    protected $model = null;

    public function _initialize()
    {
        parent::_initialize();
        $this->model = new \app\admin\model\Test;
    }

    public function index()
    {
        if ($this->request->isAjax()) {
            list($where, $sort, $order, $offset, $limit) = $this->buildparams();
            $list = $this->model
                ->where($where)
                ->order($sort, $order)
                ->paginate($limit);
            $result = array("total" => $list->total(), "rows" => $list->items());
            return json($result);
        }
        return $this->view->fetch();
    }
}

7.3 自定义模型

创建模型

<?php
namespace app\admin\model;

use think\Model;

class Test extends Model
{
    protected $name = 'test';
    protected $autoWriteTimestamp = 'int';
    protected $createTime = 'createtime';
    protected $updateTime = 'updatetime';
    protected $dateFormat = false;

    // 定义获取器
    public function getStatusTextAttr($value, $data)
    {
        $status = [0 => '禁用', 1 => '正常'];
        return $status[$data['status']];
    }
}

八、总结

通过以上步骤，您已经成功搭建了 FastAdmin 的开发环境。FastAdmin 作为一款基于 ThinkPHP 的快速开发框架，具有以下优势：

1. 快速开发：一键生成 CRUD，自动生成控制器、模型、视图、JS、语言包等
2. 权限管理：完善的权限控制系统，支持无限级父子级权限继承
3. 扩展性强：丰富的插件系统，支持快速扩展功能
4. 界面美观：基于 Bootstrap 和 AdminLTE，响应式设计
5. 文档完善：官方提供详细的开发文档和视频教程

在实际开发中，建议：

• 使用 Composer 方式安装，便于后续更新
• 配置好 PhpStorm 开发环境，提高开发效率
• 熟悉 FastAdmin 的 CRUD 生成器和权限系统
• 参考官方文档（https://doc.fastadmin.net）解决开发中的问题

通过不断实践和探索，您将能够快速掌握 FastAdmin 框架，高效开发各种后台管理系统。