Laravel Idea - Laravel 智能导航扩展

专为 Laravel 开发者打造的智能代码导航工具
简化路由、中间件、命令、配置之间的跳转操作

A powerful Laravel development extension that provides intelligent navigation and code jumping capabilities between routes, middleware, commands, and configurations.

🔥 最佳实践推荐 / Best Practice

💡 建议与 PHP Tools 插件配合使用

Laravel Idea 专注于 Laravel 框架特性的智能导航，是对 PHP Tools 在 Laravel 框架支持上的有效补充。
两者组合使用，提供更完整的 Laravel 开发体验。

Recommended to use with PHP Tools

Laravel Idea focuses on Laravel framework-specific navigation, effectively complementing PHP Tools.
Together, they provide a more complete Laravel development experience.

📖 目录 / Table of Contents

• 为什么选择 Laravel Idea
• 快速开始
• 关于功能
• 核心功能与使用
• 扩展命令
• 配置选项

🎯 为什么选择 Laravel Idea / Why Choose Laravel Idea

🎪 完美搭档 / Perfect Partnership

💎 专业的事交给专业的工具做

在 Laravel 开发中，PHP Tools 提供了优秀的 PHP 语言支持，但对于 Laravel 框架特有的路由、中间件、命令等特性支持有限。Laravel Idea 正是为了填补这一空白而生！

• PHP Tools 👉 负责 PHP 语言层面（类、方法、变量、命名空间等）
• Laravel Idea 👉 专注 Laravel 框架层面（路由、中间件、命令、配置等）

两者配合，提供更完整的 Laravel 开发体验。

开发痛点 / Development Pain Points

在大型 Laravel 项目中，即使有了 PHP Tools，你是否仍然遇到这些框架层面的问题？

Even with PHP Tools, do you still encounter these Laravel framework-specific issues?

• ❌ 路由定义在 routes/api.php，控制器在 app/Api/Controllers/V1/Erp/，PHP Tools 无法识别字符串形式的路由定义
• ❌ 中间件配置散落在多个路由文件中，想找某个中间件的所有使用位置需要全局搜索
• ❌ 定时任务配置在 Kernel.php，命令类在 Commands/ 目录，两者通过字符串关联，无法智能跳转
• ❌ 配置项在代码中使用 config('aliyun.oss.bucket')，PHP Tools 无法解析这种动态配置调用

解决方案 / Solutions

✅ 一键跳转 - Ctrl+点击即可在路由、控制器、中间件、命令之间自由跳转
✅ 双向导航 - 不仅可以从路由跳转到控制器，还能从控制器反向查找所有相关路由
✅ 实时解析 - 文件修改后自动更新缓存，无需手动刷新
✅ 智能匹配 - 支持复杂的命名空间、嵌套路由组、带参数的中间件等
✅ 无缝集成 - 与 PHP Tools 有效配合，互不干扰，共同提供完整开发体验

快速开始 / Quick Start

💡 重要提示 / Important Notice

🔥 推荐配合使用 / Recommended Combo

本扩展专为 Laravel 框架优化，强烈建议配合 PHP Tools 插件使用！

Laravel Idea 专注于 Laravel 特有的路由、中间件、命令等框架层面的智能跳转，有效补充了 PHP Tools 在 Laravel 框架特性上的不足。两者配合使用，将为你提供更完整的 Laravel 开发体验：

• ✅ PHP Tools: 提供 PHP 语言的智能感知、代码补全、类跳转、重构等基础能力
• ✅ Laravel Idea: 提供 Laravel 框架的路由跳转、中间件导航、命令跳转、配置导航等专属功能

This extension is specifically optimized for Laravel framework. We strongly recommend using it together with PHP Tools!

Laravel Idea focuses on Laravel-specific intelligent navigation for routes, middleware, commands, etc., effectively complementing PHP Tools' capabilities. Together, they provide a more complete Laravel development experience:

• ✅ PHP Tools: PHP language intelligence, code completion, class navigation, refactoring, etc.
• ✅ Laravel Idea: Laravel framework-specific route navigation, middleware jumps, command jumps, config navigation, etc.

安装 / Installation

1. 打开 VS Code，进入扩展市场 (Ctrl+Shift+X)
2. 搜索 "Laravel Idea"
3. 点击"安装"按钮
4. [推荐] 同时安装 "PHP Tools" 插件以获得完整开发体验
5. 打开你的 Laravel 项目，即刻享受智能跳转！

立即体验 / Try It Now

// 在 routes/api.php 中，按住 Ctrl 并点击控制器名
Route::post('/users/create', 'UserController@store');
//                            👆 点击这里跳转到控制器方法

// 在 UserController.php 中，点击方法名查找对应路由
public function store() { }
//              👆 点击这里查找所有相关路由

// 在路由中，点击中间件名跳转到定义
Route::middleware(['auth', 'throttle:60,1'])->group(function () {
//                  👆                👆
//            跳转到 Kernel.php   跳转到 Kernel.php
});

// 在定时任务中，点击命令名跳转到命令类
$schedule->command('sync:user-data')->daily();
//                  👆 点击这里跳转到命令类

💡 关于功能 / About Features

📝 这些功能都来自实际开发痛点

本扩展的所有功能都是作者在日常 Laravel 开发中遇到的真实痛点。我们深知大型 Laravel 项目中代码导航的困难，因此专注于解决这些实际问题。

💬 需要其他功能？
如果你在使用过程中有任何功能需求或改进建议，欢迎在 GitHub Issues 留言反馈！我们会根据使用情况和社区反馈持续优化和添加新功能。

📝 All features are born from real development pain points

Every feature in this extension comes from actual challenges the author faced in daily Laravel development. We understand the difficulties of code navigation in large Laravel projects and focus on solving these real problems.

💬 Need other features?
If you have any feature requests or suggestions during use, feel free to leave feedback on GitHub Issues! We will continue to optimize and add new features based on usage and community feedback.

✨ 核心功能与使用 / Core Features & Usage

1️⃣ 路由 ↔ 控制器跳转 / Route ↔ Controller Navigation

基本使用 / Basic Usage

支持的路由格式：Route::、$api-> 等主流格式，完整支持 Controller@action 语法。

// ✅ 标准 Laravel 路由
Route::post('/users', 'UserController@store');
$api->post('user-list', 'UserController@list');

// ✅ 点击不同位置有不同效果
$api->post('batch-add-goods', 'GoodsController@batchAddGoods');
//          👆 无跳转          👆 跳转到类  👆 跳转到方法

双向导航 / Bidirectional Navigation

// 👉 从路由跳转到控制器
// routes/api.php
Route::post('/users/create', 'UserController@store');
//                            👆 Ctrl+点击跳转到 UserController::store()

// 👈 从控制器跳转到路由
// app/Http/Controllers/UserController.php
class UserController extends Controller
{
    public function store() { }
    //     👆 Ctrl+点击查找所有使用此方法的路由
}

智能命名空间解析 / Intelligent Namespace Resolution

// 支持多层嵌套路由组，自动构建完整命名空间
Route::group([
    'namespace' => '\App\Api\Controllers\V1',  // 第1层命名空间
    'prefix' => 'v1',
], function ($api) {
    $api->group(['namespace' => 'Erp', 'prefix' => 'erp'], function ($api) {  // 第2层
        $api->group(['namespace' => 'Warehouse', 'prefix' => 'warehouse'], function ($api) {  // 第3层
            // 最终命名空间: \App\Api\Controllers\V1\Erp\Warehouse
            $api->post('check/list', 'CheckController@list');
            //                       👆 跳转到: \App\Api\Controllers\V1\Erp\Warehouse\CheckController
        });
    });
});

2️⃣ 中间件导航 / Middleware Navigation

双向跳转：从路由跳转到中间件定义，或从中间件定义查找所有使用位置。

// 路由中点击中间件名跳转
Route::group([
    'middleware' => ['checkUserLogin', 'throttle:200,1,user_id'],
    //               👆 Ctrl+点击跳转到 Kernel.php
], function ($api) { /* ... */ });

// Kernel.php 中点击中间件名查找使用位置
protected $routeMiddleware = [
    'checkUserLogin' => CheckUserLoginMiddleware::class,
    //👆 Ctrl+点击查找所有使用此中间件的路由
];

支持：链式中间件、withoutMiddleware、带参数的中间件（如 throttle:200,1）。采用实时解析，无需刷新缓存。

3️⃣ 定时任务 ↔ 命令类跳转 / Schedule ↔ Command Navigation

双向跳转：从定时任务跳转到命令类，或从命令类查找对应的定时任务。

// Kernel.php 中点击命令名跳转到命令类
$schedule->command('upload:ai-ident-image')->daily();
//                  👆 Ctrl+点击跳转到 UploadAiIdentImageCommand

// 命令类中点击类名查找定时任务
class UploadAiIdentImageCommand extends Command
//    👆 Ctrl+点击查找对应的定时任务
{
    protected $signature = 'upload:ai-ident-image';
}

智能转换：自动处理命令名到类名的转换（如 upload:ai-ident-image → UploadAiIdentImageCommand），支持带参数的命令。

4️⃣ 配置导航 / Configuration Navigation

双向跳转：从配置文件跳转到使用位置，或从代码跳转到配置定义。

// config/aliyun.php 中点击键名查找使用位置
return [
    'access_key_id' => env('ALIYUN_ACCESS_KEY_ID', ''),
    //👆 Ctrl+点击查找所有使用 config('aliyun.access_key_id') 的位置
    
    'oss' => [
        'region' => env('ALIYUN_OSS_REGION', ''),
        //👆 支持多级配置键
    ],
];

// 代码中点击配置键跳转到定义
$key = config('aliyun.access_key_id');
//              👆 Ctrl+点击跳转到 config/aliyun.php

智能过滤：自动跳过被注释的配置调用，只跳转到实际生效的代码。

⚙️ 扩展命令 / Extension Commands

打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）输入以下命令：

⚙️ 配置选项 / Configuration

扩展提供了丰富的配置选项，可以根据项目实际情况进行调整。

路径匹配配置 / Path Pattern Configuration

打开 VS Code 设置（File > Preferences > Settings），搜索 "Laravel Idea"，可以配置以下选项：

项目目录配置 / Directory Configuration

快捷键配置 / Keybinding Configuration

PHPStorm 风格快捷键（基础版本）

PHPStorm 风格快捷键（高级版本）

⚠️ 注意：高级版本包含基础版本的所有快捷键，并额外添加以下快捷键（可能与 VS Code 默认快捷键冲突）

配置示例 / Configuration Example

如果您的项目结构不同于标准 Laravel，可以自定义路径模式：

{
  "laravelIdea.routeFilePattern": "/custom-routes/",
  "laravelIdea.controllerFilePattern": "MyController",
  "laravelIdea.controllerPath": "app/MyApp/Controllers"
}

🤝 贡献 / Contributing

欢迎贡献代码、报告问题或提出建议！

Contributions, issues, and feature requests are welcome!

贡献指南 / Contribution Guidelines

1. Fork 本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

报告问题 / Report Issues

在 GitHub Issues 提交问题时，请提供：

• VS Code 版本
• 扩展版本
• Laravel 版本
• 问题描述和复现步骤
• 相关代码示例

📜 许可证 / License

本项目基于 MIT License 开源。

This project is licensed under the MIT License.

💖 致谢 / Acknowledgments

感谢所有使用和支持 Laravel Idea 的开发者！

Thanks to all developers who use and support Laravel Idea!

如果这个扩展对你有帮助，请在 VS Code 市场 给个五星好评 ⭐️

If this extension helps you, please give it a 5-star rating on the VS Code Marketplace ⭐️