首先确认PHP版本并启用必要扩展，再通过Composer安装依赖；接着配置数据库信息并导入数据表结构；然后设置Web服务器重写规则以正确访问后台；之后执行命令创建管理员账户；最后注册新模块并调整路由与视图文件完成二次开发。
如果您尝试部署或基于 LyAdmin 进行后台功能扩展，但遇到安装失败或无法加载管理界面的情况，可能是由于环境配置不匹配或初始化流程未完成。以下是完整的安装与二次开发操作步骤：
本文运行环境：联想小新 Pro 14，Windows 11
一、环境准备与依赖安装
LyAdmin 基于 PHP 框架开发，需确保系统具备正确的运行环境。缺少必要的扩展模块将导致安装中断或功能异常。
1、确认已安装 PHP 8.0 或更高版本，通过命令行执行 php -v 验证版本信息。
立即学习“PHP免费学习笔记（深入）”；
2、启用 required 扩展：打开 php.ini 文件，确保以下扩展已取消注释：extension=mysqli、extension=pdo_mysql、extension=openssl。
3、使用 Composer 安装项目依赖，在项目根目录执行：composer install，等待第三方库自动下载完成。
二、数据库配置与初始化
系统需要正确连接 MySQL 数据库，并导入初始数据结构以支持后台功能运行。
1、在 MySQL 中创建新数据库，例如命名为 lyadmin_db，并设置用户权限。
2、修改配置文件 config/database.php，更新以下字段：
-'hostname' => '127.0.0.1',
-'username' => 'root',
-'password' => 'your_password',
-'database' => 'lyadmin_db'
3、导入 SQL 文件：执行 php think migrate:run 自动创建数据表结构。
三、后台访问路径配置
默认情况下，管理界面位于特定路由下，若未正确配置 Web 服务器则无法访问入口文件。
1、Apache 用户需确保 .htaccess 文件存在且开启 Rewrite 模块，访问路径为 http://your-domain.com/public/admin。
2、Nginx 用户添加重写规则：
location / {
if (!-e $request_filename){
rewrite ^/(.*)$ /public/index.php?s=$1 last;
}
}
3、检查 public 目录权限，确保 Web 服务用户（如 www-data）具有读取和执行权限。
四、管理员账户初始化
首次运行需创建超级管理员账号，否则无法登录后台管理系统。
1、执行内置命令生成初始用户：php think create:admin --username=admin --password=123456。
2、登录后立即修改密码，避免使用默认凭证带来安全风险。
3、如需批量导入管理员，可通过 SQL 插入语句向 sys_user 表添加记录，注意密码需使用框架提供的哈希函数加密。
五、二次开发模块注册
新增业务功能前，必须在系统中注册模块并绑定路由，否则无法被框架识别。
1、在 app 目录下创建新模块文件夹，例如 app/order，并生成控制器和服务类。
2、编辑 config/app.php，将模块加入 'app_namespace' 和 'default_module' 列表。
3、在 route/route.php 中添加路由规则，示例：Route::rule('order/list','order/OrderController@getList');
六、前端页面定制化修改
LyAdmin 使用 ThinkPHP 模板引擎渲染后台界面，可通过修改视图文件实现 UI 调整。
1、定位页面模板路径，通常位于 view/admin/module_name/action_name.html。
2、编辑 HTML 文件时，保留原有 block 标签结构，仅替换内容区域元素。
3、引入自定义 JS 脚本时，应放在 {block name="script"}{/block} 区域内，防止布局错乱。
