如何使用Composer打包Laravel应用？仅打包自定义开发文件

嘿，我完全懂你的需求——不想把整个Laravel框架都打包分享，只想把自己写的控制器、模型、视图这些核心代码抽出来，让别人能通过Composer一键安装到他们的Laravel项目里，对吧？这完全可行，下面我一步步给你拆解实现步骤：

1. 搭建Composer包的基础结构 #

首先创建一个单独的目录（比如laravel-custom-app），这就是你的包根目录，结构要遵循Composer规范：

laravel-custom-app/
├── src/
│   ├── Http/
│   │   └── Controllers/  # 你的自定义控制器
│   ├── Models/           # 你的自定义模型
│   ├── routes/           # 你的自定义路由文件
│   ├── database/         # 迁移文件（如果有的话）
│   └── CustomAppServiceProvider.php  # 核心服务提供者
├── resources/
│   ├── views/            # 你的自定义视图
│   └── assets/           # CSS/JS/图片等静态资源
└── composer.json         # Composer配置文件

然后编写composer.json，这是包的核心配置，示例如下：

{
    "name": "your-vendor/custom-app",
    "description": "自定义Laravel业务代码包",
    "type": "laravel-package",
    "license": "MIT",
    "authors": [
        {
            "name": "你的名字",
            "email": "你的邮箱"
        }
    ],
    "require": {
        "php": "^8.0",
        "laravel/framework": "^9.0|^10.0"  # 适配的Laravel版本
    },
    "autoload": {
        "psr-4": {
            "YourVendor\\CustomApp\\": "src/"
        }
    },
    "extra": {
        "laravel": {
            "providers": [
                "YourVendor\\CustomApp\\CustomAppServiceProvider"
            ],
            "aliases": {
                "CustomApp": "YourVendor\\CustomApp\\Facades\\CustomApp"  # 如果需要Facade的话
            }
        }
    }
}

注意把your-vendor和YourVendor换成你的实际命名空间前缀，比如你的GitHub用户名或者团队名。

2. 组织你的自定义代码 #

• 控制器/模型：按照PSR-4规范放在src/Http/Controllers和src/Models里，每个文件的命名空间要对应YourVendor\CustomApp\Http\Controllers或者YourVendor\CustomApp\Models。
• 视图：放在resources/views里，比如resources/views/dashboard.blade.php，后面会通过服务提供者注册到Laravel的视图系统。
• 静态资源：CSS/JS/图片放在resources/assets下，比如resources/assets/css/custom.css，后面会发布到Laravel项目的public/vendor目录。
• 路由：在src/routes下创建web.php或api.php，比如：

<?php

use Illuminate\Support\Facades\Route;
use YourVendor\CustomApp\Http\Controllers\DashboardController;

Route::get('/custom-dashboard', [DashboardController::class, 'index'])->name('custom.dashboard');

3. 创建核心服务提供者 #

服务提供者是你的包和Laravel框架之间的桥梁，所有资源注册、路由加载、配置发布都靠它来完成。在src/CustomAppServiceProvider.php里编写如下代码：

<?php

namespace YourVendor\CustomApp;

use Illuminate\Support\ServiceProvider;

class CustomAppServiceProvider extends ServiceProvider
{
    /**
     * 注册服务
     */
    public function register(): void
    {
        // 如果有自定义配置文件，在这里合并
        $this->mergeConfigFrom(__DIR__.'/../config/custom-app.php', 'custom-app');
    }

    /**
     * 启动服务（加载资源、路由等）
     */
    public function boot(): void
    {
        // 加载自定义路由
        $this->loadRoutesFrom(__DIR__.'/routes/web.php');

        // 注册视图，使用命名空间'custom-app'，这样可以用view('custom-app::dashboard')访问
        $this->loadViewsFrom(__DIR__.'/../resources/views', 'custom-app');

        // 发布视图到Laravel项目的resources/views/vendor/custom-app目录（可选，用户可以自定义修改）
        $this->publishes([
            __DIR__.'/../resources/views' => resource_path('views/vendor/custom-app'),
        ], 'custom-app-views');

        // 发布静态资源到Laravel项目的public/vendor/custom-app目录
        $this->publishes([
            __DIR__.'/../resources/assets' => public_path('vendor/custom-app'),
        ], 'custom-app-assets');

        // 如果有迁移文件，加载迁移
        $this->loadMigrationsFrom(__DIR__.'/../database/migrations');

        // 如果有Artisan命令，注册命令
        // $this->commands([
        //     \YourVendor\CustomApp\Console\Commands\CustomCommand::class,
        // ]);
    }
}

4. 打包与测试你的包 #

本地测试 #

在你要测试的Laravel项目的composer.json里添加本地包的仓库地址：

"repositories": [
    {
        "type": "path",
        "url": "../laravel-custom-app"  # 你的包目录相对于Laravel项目的路径
    }
]

然后运行命令安装你的包：

composer require your-vendor/custom-app

安装完成后，Laravel会自动注册服务提供者。如果需要发布资源，运行：

php artisan vendor:publish --tag=custom-app-views
php artisan vendor:publish --tag=custom-app-assets

现在就可以访问你的自定义路由、视图了，测试没问题就可以准备分享了。

分享给他人 #

如果要公开分享，可以把你的包上传到Packagist；如果是内部使用，可以搭建私有Composer仓库，用户只需要在他们的Laravel项目里执行composer require your-vendor/custom-app就能一键安装你的自定义代码，完全不需要整个Laravel项目副本。

5. 额外优化点 #

• 配置文件：如果有自定义配置，在包根目录创建config/custom-app.php，然后在服务提供者的register方法里合并配置，并且添加发布规则到publishes里。
• Facade：如果需要简化调用，可以创建Facade类，在extra.laravel.aliases里注册。
• 语言包：如果有多语言需求，把语言文件放在resources/lang，然后用$this->loadTranslationsFrom()注册。

内容的提问来源于stack exchange，提问作者Mohammad