安装Laravel 11之前选确保安装了Composer 管理器，接下来的步骤是通过Composer 包管理器安装完成的。
一、前提条件
- 服务器要求
- PHP >= 8.1。确保你的服务器环境已经安装并配置好符合要求的 PHP 版本。你可以通过在命令行中输入
php -v来检查 PHP 版本。 - Composer：Laravel 使用 Composer 来管理依赖。确保已经安装了 Composer。可以通过在命令行中输入
composer -v来检查是否安装成功。如果没有安装，你可以根据操作系统的不同，参考 Composer 官方文档进行安装。
- PHP >= 8.1。确保你的服务器环境已经安装并配置好符合要求的 PHP 版本。你可以通过在命令行中输入
- 数据库（可选，但对于大多数应用是需要的）
- Laravel 支持多种数据库，如 MySQL、PostgreSQL、SQLite 等。如果使用 MySQL，需要确保已经安装并配置好 MySQL 服务器，并且记录好数据库的用户名、密码和数据库名称等信息，以便在配置 Laravel 时使用。
二、使用 Composer 创建新的 Laravel 11 项目
- 打开终端（命令提示符或者类似的工具），切换到你想要安装 Laravel 项目的目录。例如，如果你想将项目安装在
/var/www/site.com（这是在 Linux 环境下的一个常见的 Web 目录，在 Windows 下你可以选择如D:\projects等目录），可以使用cd命令来切换目录。- 在 Linux/macOS 下：
cd /var/www/site.com - 在 Windows 下：
cd D:\projects
- 在 Linux/macOS 下：
- 运行以下 Composer 命令来创建一个新的 Laravel 11 项目。项目名称可以自定义，这里假设项目名称为
my_laravel_app：composer create-project laravel/laravel my_laravel_app- 这个命令会从 Packagist（PHP 的软件包仓库）下载 Laravel 11 的代码，并根据模板创建一个新的项目。它会自动安装所有必要的依赖项，这个过程可能需要一些时间，具体取决于你的网络速度和服务器性能。
- 配置环境文件：
- 进入新创建的项目目录：
cd my_laravel_app - 复制
.env.example文件为.env：cp.env.example.env - 打开
.env文件，配置数据库连接信息（如果需要使用数据库）。例如，对于 MySQL，你需要配置DB_CONNECTION=mysql，DB_HOST=127.0.0.1（如果数据库在本地），DB_PORT=3306，DB_DATABASE=your_database_name，DB_USERNAME=your_username，DB_PASSWORD=your_password。 - 你还可以配置其他环境相关的选项，如应用程序的密钥（
APP_KEY），在 Laravel 11 中，你可以通过运行php artisan key:generate来生成一个新的应用程序密钥，它会自动填充到.env文件的APP_KEY字段。
- 进入新创建的项目目录：
- 安装依赖：
- 虽然在创建项目时已经安装了大部分依赖，但有时候可能需要安装额外的扩展包或者更新现有依赖。在项目目录下运行
composer install或者composer update可以确保所有依赖项都是最新的并且正确安装。
- 虽然在创建项目时已经安装了大部分依赖，但有时候可能需要安装额外的扩展包或者更新现有依赖。在项目目录下运行
- 启动开发服务器（仅用于开发环境）：
- Laravel 自带了一个简单的开发服务器，可以用于在开发阶段快速查看应用程序。在项目目录下运行
php artisan serve，这会启动一个本地服务器，默认监听在http://127.0.0.1:8000。你可以在浏览器中访问这个地址来查看你的 Laravel 应用程序的初始页面。
- Laravel 自带了一个简单的开发服务器，可以用于在开发阶段快速查看应用程序。在项目目录下运行
三、在现有项目中添加 Laravel 11（如果是集成到现有项目）
- 进入现有项目的目录。
- 修改项目的
composer.json文件，在require部分添加laravel/laravel依赖："laravel/laravel": "11.*"
- 然后在项目目录下运行
composer update命令来下载并安装 Laravel 11 相关的包。 - 按照上述步骤配置环境文件和其他相关设置，如数据库连接等，确保 Laravel 能够正常工作在现有项目环境中。
请注意，在实际安装过程中，可能会遇到各种问题，如权限问题（在 Linux 下，如果没有足够的权限来安装文件，可能需要使用sudo命令）、网络问题（无法下载依赖包）或者配置问题（数据库连接失败等）。如果遇到问题，可以查看 Laravel 官方文档的故障排除部分或者在相关的开发者社区寻求帮助。
一、安装 Filament
使用 Composer 安装 Filament：
打开终端，进入你的 Laravel 项目的根目录。
composer require filament/filament- 这将从 Composer 仓库中下载 Filament 所需的 PHP 依赖包并安装到你的 Laravel 项目中。
- 安装 Filament 的前端资源：
php artisan filament:install --panels- 这个命令将运行一系列的安装步骤，包括安装前端资源（如 Vue.js 组件），发布必要的配置文件和资源文件，以及执行数据库迁移等操作。
- 前端资源安装：它会利用 Laravel 的前端构建工具（如 Laravel Mix 或 Vite）来安装和编译 Filament 的 Vue.js 组件和相关的 CSS 文件。
- 配置文件和资源文件发布：会将 Filament 的配置文件和必要的资源文件发布到你的 Laravel 项目中，你可以在
config目录下找到 Filament 的配置文件，根据需要修改它们。 - 数据库迁移：可能会包含一些必要的数据库迁移，以存储 Filament 的数据，如用户角色、权限等信息。你可以在
database/migrations目录中看到相关的迁移文件。
- 编译前端资源：
- 如果你的 Laravel 项目使用 Laravel Mix 进行前端资源管理，可以运行以下命令来编译前端资源：
npm install && npm run dev如果使用 Vite，运行：
npm install && npm run build- 这些命令将确保 Filament 的前端资源被正确编译和优化，以便在浏览器中正常使用。
三、配置 Filament
- 打开
config/filament.php文件（如果存在），你可以在这里配置 Filament 的各种选项，例如：- 注册和登录页面：你可以自定义 Filament 的注册和登录页面的行为，例如是否启用注册功能，自定义登录页面的外观等。
- 权限管理：Filament 提供了强大的权限管理功能，你可以在这里配置用户角色和权限，决定哪些用户可以访问哪些功能。
- 面板管理：如果你使用多个 Filament 面板，可以在这里配置它们的路由、中间件等信息。
- 如果你需要自定义 Filament 的外观或添加自己的资源（如自定义的表单、表格等），可以创建相应的资源文件。通常，可以使用 Artisan 命令生成 Filament 资源模板，例如：
php artisan make:filament-resource Post- 这个命令将创建一个新的 Filament 资源文件，你可以在
app/Filament/Resources目录中找到并修改它，以添加自定义的功能。
四、运行项目
- 确保你已经完成了数据库迁移。如果在安装 Filament 过程中生成了数据库迁移文件，可以使用以下命令运行迁移：
php artisan migrate启动 Laravel 开发服务器：
php artisan serve- 打开浏览器，访问
http://127.0.0.1:8000/admin（默认的 Filament 管理面板地址），你应该可以看到 Filament 的管理面板界面。
五、故障排除
- Composer 安装错误：如果在使用
composer require filament/filament时遇到错误，可能是由于网络问题或依赖冲突。可以尝试使用composer clear-cache命令清除 Composer 的缓存，然后再次尝试安装。 - 前端资源编译错误：如果在编译前端资源时遇到错误，检查 Node.js 版本是否兼容，确保
package.json中的依赖包版本正确，也可以查看node_modules目录下的日志文件或在运行npm run dev或npm run build时显示的错误信息。 - 数据库迁移问题：确保你的数据库连接信息在
.env文件中正确配置，并且数据库服务器正常运行。如果迁移失败，检查database/migrations目录下的迁移文件是否存在错误，或者使用php artisan migrate:rollback回滚迁移，修复问题后再重新运行迁移。
安装 Filament 可以为你的 Laravel 项目带来一个强大的管理面板，通过上述步骤，你可以顺利地将 Filament 集成到你的 Laravel 项目中，并根据自己的需求进行配置和扩展。在整个过程中，如果遇到问题，可以参考 Filament 的官方文档和 Laravel 的官方文档。
发布者：myrgd，转载请注明出处：https://www.object-c.cn/5232
