README

在虫子咬你之前找出它们

用❤️为懒惰的laravel开发者打造 ;)

为什么重复旧错误，如果还有这么多新错误可以犯呢？

(伯特兰·罗素)

让您的眼睛休息一下，我们将为您检测和修复它们。

关键事项

它被创建成比phpstorm和其他IDE更智能地查找错误。
它被创建成理解laravel运行时和魔法。
它不会向您显示愚蠢的假错误，所有报告的情况都是真正的错误。
即使您已经为您的应用编写了大量的测试，您仍然可能需要这个。
它可以通过自动应用early returns来重构您的代码。
它是从头开始编写的，以产生尽可能高的性能。

🎞️ 视频教程在这里

⭐ 您的星星让我们做得更多

如果您发现这个包很有用，并且想鼓励维护者继续工作，只需按星号按钮即可声明您的意愿。

星星收藏者

⬇️ 安装

您可以通过composer 安装此包

composer require imanghafoori/laravel-microscope --dev

您还可以选择发布配置文件

php artisan vendor:publish --provider="Imanghafoori\LaravelMicroscope\LaravelMicroscopeServiceProvider"

💎 使用

有用的命令

您可以运行 👇

较少使用的命令

全局辅助函数

此外，您将能够访问一些全局辅助函数

microscope_dd_listeners($event);

如果您想知道监听器是什么以及它们在哪里，您可以在boot或register方法中调用microscope_dd_listeners(MyEvent::class);。它就像一个正常的dd(...);，意味着程序将在该点停止运行。

📖 命令的作用是什么？

让我们从

`php artisan search_replace {--name=pattern_name} {--tag=some_tag} {--file=partial_file_name} {--folder=partial_folder_name}`

这是一个智能且非常强大的搜索/替换功能，可以真正为您节省时间。

1️⃣ 定义模式

如果您第一次运行artisan search_replace命令，它将在项目的根目录中创建一个search_replace.php文件。然后，您可以在该文件中定义您的模式。

示例

让我们定义一个将全局辅助函数optional()替换为?-> php 8 null安全操作符的模式。

return [
    'optional_to_nullsafe' => [
        'search' => '"<global_func_call:optional>"("<in_between>")->',
        'replace' => '"<2>"?->',
        // 'tag' => 'php8,refactor',
        // 'predicate' => function($matches, $tokens) {...},
        // 'mutator' => function($matches) {...},
        // 'post_replace' => [...],
        // 'avoid_result_in' => [...],
        // 'avoid_syntax_errors' => false,
        // 'filters' => [...],
    ]
];

这里的关键 optional_to_nullsafe 是你模式的“唯一名称”。(你可以通过运行 php artisan search_replace --name=optional_to_nullsafe 来定位你的模式)
搜索模式有一个 "<in_between>" 占位符，它可以捕获括号之间的所有内容。
在 replace 块中，我们用 "<1>" 替换第一个占位符所捕获的内容。如果我们有更多的占位符，我们可以使用 "<2>" 等。
在标签块中，我们可以将一些标签作为字符串数组或用逗号分隔的字符串来提及，并通过 --tag 标志进行定位： php artisan search_replace --tag=php8

2️⃣ 占位符：

以下是你可以使用的占位符的完整列表

如果需要，你也可以定义自己的关键词！

你只需定义一个为你新关键词的类，并将类路径追加到 Finder::$keywords[] = MyKeyword::class 属性的末尾。就像默认关键词一样。

示例

1️⃣ 假设你只想找到包含“todo:”这个词的“注释”。

 'todo_comments' => [
        'search' => '<comment>',
        'predicate' => function($matches) {    //   <====  here we check comment has "todo:"
            $comment = $matches[0]; // first placeholder value
            $content = $comment[1]; // get its content
            
            return Str::contains($content, 'todo:') ? true : false;
        },
]

注意如果你没有提及 'replace' 键，它只会搜索并将它们报告给你。

2️⃣ 好的，现在假设你想要从你的注释中移除“todo:”这个词

 'remove_todo_comments' => [
    'search' => '<comment>',      //   <=== we capture any comment
    'replace' => '<1>',

    'predicate' => function($matches) {
        $comment = $matches[0]; // first matched placeholder
        $content = $comment[1];

        return Str::contains($content, 'todo:') ? true : false;
    },

    'mutator' => function ($matches) {       //  <=== here we remove "todo:"
        $matches[0][1] = str_replace('todo:', '', $matches[0][1]);

        return $matches;
    }
]

转换为： // todo: refactor code 为： // refactor code

3️⃣ 变换器： 在变换器中，你可以在替换结果之前，根据需要自由地操作 $matched 值。你也可以提到一个静态方法而不是函数，如下所示： [MyClass::class, 'myStaticMethod']

3️⃣ 假设你想要在数组中如果缺少可选逗号的话，为 Let's 元素添加。

    'enforce_optional_comma' => [
        'search' => '<white_space>?]',
        'replace' => ',"<1>"]',
        'avoid_syntax_errors' => true,
        'avoid_result_in' => [
           ',,]',
           '[,]',
           '<var>[,]'
       ],
    ]

在这种情况下，我们的模式并不非常精确，在某些情况下可能会导致语法错误。因此，我们打开了 php 语法验证器来检查结果，但这会给我们带来性能损失！！！为了排除在结果中使用 php，为了验证结果，我们已经提到了 avoid_result_in，所以如果它们发生，它就会跳过。

注意：在 "<white_space>?" 中的 ? 表示这是一个 可选 占位符。

如果你好奇想要一个不需要任何语法检查的更好模式，试试这个

'enforce_optional_comma' => [
       'search' => '<1:any><2:white_space>?[<3:until_match>]',
       'replace' => '<1><2>[<3>,]',
       'avoid_result_in' => [
           ',,]',
           '[,]'
       ],
       'predicate' => function ($matches) {
           $type = $matches['values'][0][0];

           return $type !== T_VARIABLE && $type !== ']';
       },
       'post_replace' => [
           '<1:white_space>,]' => ',<1>]'
       ]
],

这更复杂，但运行得更快。（因为它不需要 php 语法验证器）

在这里 'post_replace' 是一个只应用于结果代码以进行精炼，而不是整个文件的模式。
你可以可选地注释你的占位符（如上所示 <1:any>），用数字标记，这样你知道替换时哪个对应哪个。

4️⃣ 过滤器：

目前，显微镜只提供了两个内置过滤器： is_sub_class_of 和 in_array

你能猜出这个模式在做什么吗？！

 'mention_query' => [
      'search' => '<1:class_ref>::<2:name>'
      'replace' => '<1>::query()-><2>',
      'filters' => [
          1 => [
              'is_sub_class_of' => \Illuminate\Database\Eloquent\Model::class
          ],
          2 => [
              'in_array' => 'where,count,find,findOrFail,findOrNew'
          ]
      ]
  ]

它将这些

User::where(...)->get();

\App\Models\User::find(...);

转换为这些

User::query()->where(...)->get();

\App\Models\User::query()->find(...);

这里的过滤器确保捕获的类引用是 Laravel 模型，方法名是列表中提到的名称之一。

所以它不会干扰像这样的事情

User::all();            // The `all` method can not be preceded with `query`

UserRepo::where(...);   /// UserRepo is not a model

这是你永远无法通过正则表达式做到的事情。

5️⃣ 捕获 PHP “语句”：

假设我们想要选择 PHP 7.4 箭头函数

'fn' => [
    'search' => 'function (<in_between>)<until>{ <statement> }',
    'replace' => 'fn (<1>) => <3>',
    'tags' => 'php74,refactor',
    'mutator' => function ($matches) {
      $matches[2][1] = str_replace(['return ', ';'], '', $matches[2][1]);

      return $matches;
    }
]

在这个例子中，我们在函数体中只提到了一个“语句”。因此，如果它遇到包含两个或更多语句的函数，它会忽略它。

$closure = function ($a) use ($b) {
    return $a + $b;
};

// will become:
$closure = fn($a) => $a + $hello;

但这没有被捕获

$closure = function ($a) {
    $a++;
    return $a + $b;
};

6️⃣ <statement> 和 <until> 的区别：

它们看起来很相似，但有一个重要的情况，你不能使用<until>来正确地覆盖它！

$first = $a + $b;

$second = function ($a) {
    $a++;

    return $a;
};

如果我们这样定义我们的模式

return [
    'staty' => [
        'search' => '<var> = <until>;',   
    ]
];

对于$c = $a + $b;它们表现相同，但对于第二个"<until>";它将无法捕获整个闭包，并且会在达到$a++;时停止，这会出问题。

但如果你将模式定义为：'<var> = <statement>'，它就足够智能，可以捕获闭包定义末尾的正确分号，整个闭包都将被捕获。

7️⃣ 捕获全局函数调用：

假设你希望在推向生产之前消除所有的dd(...)或dump(...)。

return [
    'remove_dd' => [
        'search' =>  "'<global_func_call:dd,dump>'('<in_between>');", 
        'replace' => ''
    ]
];

这将不会捕获如下情况

$this->  dd('hello');          // is technically a method call
User::   dd('I am static');    // is technically a static method call
new      dd('I am a class');  // here "dd" is the name of a class.

但会检测并移除带有任何参数的实际全局dd()调用。

dd(                // <=== will be detected, even the pattern above is written all in one line.
   auth('admin')
        ->user()->id   
);
    
    
\dd(1);
dd(1);
dump(1);

8️⃣ 重复模式：

假设我们想要重构

User:where('name', 'John')->where('family', 'Dou')->where('age', 20)->get();

为

User:where([
    'name' => 'John',
    'family' => 'Dou',
    'age'=> 20,
])->get();

好的，那么这个模式会是什么样子呢？！

"group_wheres" => [
       
       'search' => '<1:class_ref>::where('<2:str>', '<3:str>')'<repeating:wheres>'->get();'
       
       'replace' => '<1>::where([
           <2> => <3>,
           "<repeating:1:key_values>"])->get();',

       'named_patterns' => [
           'wheres' => '->where(<str>, <str>)<white_space>?',
           'key_values' => '<1> => <2>,<3>',
       ]
   ]

不错吧？

可能性是无限的，天空才是极限...

`php artisan check:early_returns`

这将扫描所有加载的Psr-4类，并通过应用早期返回规则来简化函数和循环。例如

<?php

foreach ($products as $product) {
    if ($someCond) {
        // A lot of code 1
        // A lot of code 1
        // A lot of code 1
        // A lot of code 1
        // A lot of code 1
        if ($someOtherCond) {
            // A lot more code 2
            // A lot more code 2
            // A lot more code 2
            // A lot more code 2 
            // A lot more code 2
            //
        } // <--- closes second if
    } // <--- closes first if
}

将被发现并转换为

<?php

foreach ($products as $product) {
    if (! $someCond) {
        continue;
    }
    
    // A lot of code 1
    // A lot of code 1
    // A lot of code 1
    // A lot of code 1
    // A lot of code 1

    if (! $someOtherCond) {
        continue;
    }
 
    // A lot more code 2
    // A lot more code 2
    // A lot more code 2
    // A lot more code 2 
    // A lot more code 2
}

同样适用于函数和方法，但使用return

<?php

if ($cond1) {
    if ($cond2) {
        ....       
    }
}

// merge into:

if ($cond1 && $cond2) { 
    ...  
}

它还支持类似Ruby的if():/endif;语法；

<?php

if ($var1 > 1):
    if ($var2 > 2):
        echo 'Hey Man';
    endif;
endif;

// Or if you avoid putting curly braces...
if ($var1 > 1)
    if ($var2 > 2)
        echo 'Hey Man';

尽管这种重构是安全的，并且保证与之前做同样的事情，但在尝试此功能之前请谨慎提交所有内容，以防出现奇怪的错误。

`php artisan check:psr4`

它检查composer.json文件中定义的所有PSR-4自动加载，并遍历所有类以获得正确的命名空间，根据PSR-4标准。
它自动根据PSR-4规则更正命名空间。
它还检查对旧命名空间的引用并用新命名空间替换它们。

`php artisan check:generate`

你创建一个空文件，我们根据命名约定来填充它。

如果你在运行此命令后创建一个空的.php文件，该文件以ServiceProvider.php结尾：1 - 它将被填充模板和正确的Psr-4命名空间。2 - 它将被添加到config/app.php中的providers数组。

`php artisan check:imports`

它检查所有导入（use语句）是否有效，并报告无效的导入。
它可以自动纠正一些引用，没有对类名的歧义。
它可以理解Laravel别名类，所以use Request;是有效的。

`php artisan check:bad_practices`

它检测到不良做法，如配置文件外的env()调用。

`php artisan check:routes`

它检查你的路由是否引用有效的控制器类和方法。
它检查所有控制器方法都具有有效的类型提示。
它扫描route()、redirect()->route()、\Redirect::route()是否引用有效的路由。
它将报告没有路由指向它们的控制器公共方法。换句话说，检测到“死控制器”。

`php artisan check:compact`

在PHP 7.3中，如果你“紧凑”一个不存在的变量，你会得到一个错误，因此此命令会检查整个项目中的错误compact()调用，并向你报告应该删除哪些参数。

`php artisan check:blade_queries`

Blade文件不应该包含DB查询。我们应该将它们移回控制器并传递变量。此命令搜索所有Blade文件中的Eloquent模型和DB查询构建器，并在找到时显示它们。

`php artisan check:extract_blades`

如果你想提取Blade部分并使其包括： @include('myPartials.someFile')

你可以在Blade文件中使用!! extractBlade('myPartials.someFile') !!}来指示开始/结束行和你要创建的部分的路径/名称。

 <html>
      
      {!! extractBlade('myPartials.head') !!}
          <head>...</head>
      {!! extractBlade() !!}

      
      {!! extractBlade('myPartials.body') !!}
          <body>...</body>
      {!! extractBlade() !!}
      
 </html>

在你执行php artisan check:extract_blades之后，它将变成

<html>
    @include('myPartials.head')
    @include('myPartials.body')
</html>

此外，它还将创建

资源视图/myPartials/head.blade.php
资源视图/myPartials/body.blade.php

并将对应的内容放入其中。

它还兼容模块化Laravel应用程序中的命名空间视图。因此，此语法将正常工作：'MyMod::myPartials.body'

`php artisan check:action_comments {--file=SomeFile.php}`

这将在控制器动作中添加注释，以便您知道哪个路由指向当前控制器动作。
您可以使用--file=选项来缩小扫描的文件。

`php artisan pp:route`

首先，您必须在您的路由文件中添加以下内容：microscope_pretty_print_route('my.route.name');
您还可以将Controller@method语法传递给函数。
您可以多次调用它来美化多个路由。

`php artisan check:views`

它扫描您的代码，找到view()和View::make()，并报告它们是否引用了错误的文件。
它扫描您的blade文件中的@include()和@extends()，并报告它们是否引用了错误的文件。

此外，它还可以检测从控制器传入视图的未使用变量，如下所示：view('hello', [...]);为此，您必须在浏览器中打开页面，然后访问日志文件，以查看如下消息

local.INFO: Laravel Microscope: The view file: welcome.index-1 at App\Http\Controllers\HomeController@index has some unused variables passed to it:   
local.INFO: array ('$var1' , '$var2');

请记住，一些变量是从view composer而不是控制器传递到视图的。在检测未使用变量时，也会考虑这些变量。

`php artisan check:events`

例如，考虑以下内容

Event::listen(MyEvent::class, '\App\Listeners\MyListener@myMethod');

1 - 检查\App\Listeners\MyListener类路径是否有效。

2 - 检查myMethod方法是否存在于MyListener类上

3 - 检查myMethod方法在其签名中是否有正确的类型提示（如果有），例如

public function myMethod(OtherEvent $e) // <---- notice type-hint here
{
    //
}

这是一个有效但错误的类型提示，将会报告给您。很酷，不是吗 ??!

请注意，您设置事件监听器的方式无关紧要，

1- 在EventServiceProvider中，

2- 通过Event::listen外观，

3- 通过订阅者类...或任何其他方式。错误将会被发现。 :)

`php artisan check:gates`

它检查您定义的所有权限的有效性，确保它们引用有效的类和方法。

它还检查策略定义的有效性。

Gate::policy(User::class, 'UserPolicy@someMethod');
Gate::define('someAbility', 'UserGate@someMethod');

1 - 检查User类路径是否有效。

2 - 检查UserPolicy类路径是否有效。

3 - 检查someMethod方法是否存在。

`php artisan check:dynamic_where`

它寻找类似于whereFamilyName('...')和where('family_name', '...')的“动态where”方法。

`php artisan enforce:query`

它调用您的Eloquent查询链上的静态query方法，以便IDE可以理解Eloquent。
例如，将User::where(...转换为User::query()->where(...

`php artisan check:dead_controllers`

我们可以找到没有任何路由的控制器。

`php artisan check:generic_docblocks {--folder=app/Models} {--file=SomeFile.php}`

删除Laravel的DocBlocks。
您可以使用--folder=或--file=选项来缩小扫描的文件夹。

`php artisan enforce:helper_functions {--folder=app/Models} {--file=SomeFile.php}`

将Laravel外观转换为辅助函数。
您可以使用--folder=或--file=选项来缩小扫描的文件夹。

`php artisan list:models {--folder=app/Models}`

它在项目中搜索并列出模型类。
您可以使用--folder=选项来缩小扫描的文件夹。

更多功能将很快添加。 ;)

致谢

许可

MIT许可证（MIT）。有关更多信息，请参阅许可证文件

🙋 贡献

如果您发现一个问题或有一种更好的方法来做某事，请随时打开一个问题，或者发起一个拉取请求。如果您在开源项目中使用laravel-microscope，请创建一个拉取请求，在README.md文件中提供其URL作为示例应用程序。

❗ 安全

如果您发现任何安全相关的问题，请通过电子邮件 imanghafoori1@gmail.com 联系，而不是使用问题跟踪器。

作者的其他作品

Laravel HeyMan

💎 允许我们编写表达式丰富的代码来进行授权、验证和认证。

https://github.com/imanghafoori1/laravel-heyman

Laravel Terminator

💎 一个最小化但功能强大的包，允许您重构控制器。

https://github.com/imanghafoori1/laravel-terminator

Laravel AnyPass

💎 它允许您仅在本地环境中使用任何密码登录。

https://github.com/imanghafoori1/laravel-anypass

A man will never fail unless he stops trying.

Albert Einstein

❤️ 贡献者

本项目得以存在，多亏了所有贡献者。[贡献者].

holdon1996 / laravel_microscope_custom

维护者

详情

README

在虫子咬你之前找出它们

用❤️为懒惰的laravel开发者打造 ;)

为什么重复旧错误，如果还有这么多新错误可以犯呢？

(伯特兰·罗素)

让您的眼睛休息一下，我们将为您检测和修复它们。

关键事项

🎞️ 视频教程在这里

⭐ 您的星星让我们做得更多

⬇️ 安装

💎 使用

有用的命令

较少使用的命令

全局辅助函数

📖 命令的作用是什么？

php artisan search_replace {--name=pattern_name} {--tag=some_tag} {--file=partial_file_name} {--folder=partial_folder_name}

1️⃣ 定义模式

php artisan check:early_returns

php artisan check:psr4

php artisan check:generate

php artisan check:imports

php artisan check:bad_practices

php artisan check:routes

php artisan check:compact

php artisan check:blade_queries

php artisan check:extract_blades

php artisan check:action_comments {--file=SomeFile.php}

php artisan pp:route

php artisan check:views

php artisan check:events

php artisan check:gates

php artisan check:dynamic_where

php artisan enforce:query

php artisan check:dead_controllers

php artisan check:generic_docblocks {--folder=app/Models} {--file=SomeFile.php}

php artisan enforce:helper_functions {--folder=app/Models} {--file=SomeFile.php}

php artisan list:models {--folder=app/Models}

致谢

许可