第一章：洞府基石 (环境配置)

如果你换了一台新电脑，或者帮朋友搭建环境，请按此步骤操作。

1. 安装核心法宝 (XAMPP)

PHP 本身只是一个脚本语言，需要服务器软件才能运行。

• 下载：去 Apache Friends 下载 XAMPP (选择 PHP 8.2 或更高版本)。

• 安装：一路 Next，建议安装在 C:\xampp (不要放在中文路径下)。

• 启动：打开 XAMPP Control Panel，点击 Apache 和 MySQL 后面的 Start。

  • Apache = Web 服务器 (负责显示网页)

  • MySQL = 数据库 (负责存数据)

2. 打通经脉 (配置 PHP 环境)

这是你之前报错最多的地方，必须修改 php.ini。

1. 打开配置：在 XAMPP 面板点击 Apache 这一行的 Config -> PHP (php.ini)。

2. 解锁扩展：按 Ctrl+F 搜索以下关键词，去掉前面的分号 ;：

   • ;extension=intl (Filament 必须)

   • ;extension=zip (Composer 下载包需要)

   • ;extension=sqlite3 (如果你用 SQLite)

   • ;extension=fileinfo (图片上传需要)

3. 重启：改完保存，必须在 XAMPP 面板 Stop 再 Start Apache。

3. 请入管家 (安装 Composer)

Composer 是 PHP 的包管理器（类似 Java 的 Maven/Gradle）。

• 下载：去 getcomposer.org 下载 Windows 安装包。

• 安装：它会自动找到你的 php.exe (在 C:\xampp\php\php.exe)，一路 Next 即可。

• 验证：打开终端 (CMD 或 PowerShell)，输入 composer -V，看到版本号即成功。

---

第二章：开宗立派 (创建新项目)

当你要开始一个新的修仙项目时：

1. 创建地基 (Laravel)

在终端进入你想存放代码的目录（比如 D:\Project）：

Bash

composer create-project laravel/laravel my-project

( my-project 是你的项目名)

2. 进入宗门

Bash

cd my-project

3. 引入Filament (安装后台)

关键点： 为了稳定，我们强制指定 v3 版本。

Bash

composer require filament/filament:"^3.3.47.0" -W --no-dev

4. 宗门初始化

Bash

php artisan filament:install --panels

5. 创建掌门人 (管理员)

Bash

php artisan make:filament-user

6. 开启护山大阵 (启动服务)

Bash

php artisan serve

访问：http://127.0.0.1:8000/admin

---

第三章：藏经阁地图 (目录结构说明)

作为一个初学者，你只需要关注以下几个核心目录，其他的暂时不用管：

• 📂 app (核心代码区)

  • 📂 Models：法宝的模具（定义数据结构，如 Item.php）。

  • 📂 Filament：后台管理区。

    • 📂 Resources：具体的管理页面（如 ItemResource.php）。

• 📂 database (数据库区)

  • 📂 migrations：图纸（定义数据库表里有哪些字段）。

  • 📄 database.sqlite：你的数据文件（如果用 SQLite）。

• 📂 public：对外开放区。

  • 📂 storage：上传的图片会链接到这里。

• 📂 vendor：储物袋（存放第三方代码，如 Laravel 和 Filament，千万别手动改这里面的代码）。

• 📄 .env：宗门机密（配置数据库密码、网址等敏感信息）。

---

第四章：炼器流水线 (日常开发流程)

每当你想要添加一个新功能（比如“灵宠管理”），请严格遵守此流程：

第一步：铸造模具 (Model & Migration)

先告诉系统你要存什么。

Bash

php artisan make:model Pet -m

• Pet 是模型名（单数，大写开头）。

• -m 会同时生成数据库迁移文件。

第二步：绘制图纸 (Edit Migration)

去 database/migrations 找到新文件，在 up() 里写字段：

PHP

$table->string('name'); // 名字
$table->integer('age'); // 年龄

第三步：实体化 (Migrate)

把图纸变成真正的数据库表。

Bash

php artisan migrate

第四步：构建管理台 (Resource)

让 Filament 自动生成增删改查页面。

Bash

php artisan make:filament-resource Pet

第五步：装修 (Form & Table)

去 app/Filament/Resources/PetResource.php：

• 在 form() 里加输入框 (TextInput, Select)。

• 在 table() 里加显示列 (TextColumn, ImageColumn)。

---

第五章：万能咒语 (常用命令速查)

咒语 (Command)	作用 (Function)	什么时候用？
php artisan serve	启动服务器	每天开始干活时
php artisan migrate	更新数据库	修改了数据库字段后
php artisan make:filament-resource [Name]	生成管理页面	想加新功能（如法宝、丹药）时
php artisan make:filament-user	创建管理员	忘记密码或要加新号时
php artisan storage:link	连接图片库	项目刚建立，或者图片不显示时
php artisan optimize:clear	清理缓存	修改了配置但不生效时
composer dump-autoload	刷新类索引	报错 "Class not found" 时 (你的救命咒语)
Ctrl + C	停止运行	在终端里停止服务器

---

💡 给新手的建议

1. 不要害怕报错：报错是最好的老师。看红色的字，通常它会告诉你缺了什么（比如 Class not found）。

2. 善用 AI：把报错信息完整复制给 AI（就像你刚才做的那样），它能很快帮你定位。

3. 勤备份：在做大改动前，先把整个项目文件夹复制一份。