PHPackages                             dev-tool/laravel-dev-tool - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. dev-tool/laravel-dev-tool

ActiveLibrary[Utility & Helpers](/categories/utility)

dev-tool/laravel-dev-tool
=========================

model-annotation、ide-helper...

3.1.0(3y ago)017MITPHPPHP >=7.3.0

Since Dec 7Pushed 3y ago1 watchersCompare

[ Source](https://github.com/guxiangming/laravel-dev-tool)[ Packagist](https://packagist.org/packages/dev-tool/laravel-dev-tool)[ RSS](/packages/dev-tool-laravel-dev-tool/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (19)Used By (0)

背景
==

[](#背景)

- 在编写程序过程中，部分ide会检测标注提示所使用的类属性对象是否存在，如果不存在则警告错误，这个现象在laravel-model对象调用较为常见。在一般情况下去优化ide提示，需要进行手动写入注解，这样的步骤机械而重复。所以希望能拥有脚本能自动生成与更新文件注解。

需求调查
====

[](#需求调查)

- 经过查找php生态已经有可用的注解生成工具，但功能存在缺陷，仅支持对数据库字段进行注解。针对复杂的laravel-model需要从关联模型、表字段、attribute、casts、scope等特性考虑。

安装步骤
====

[](#安装步骤)

1. 检测composer.json是否限制中央服务器下载,如果限制则移除

```
移除代码
{
 "packagist.org": false =>  "packagist.org": true
}

```

2. 安装到开发依赖

composer require dev-tool/laravel-dev-tool --dev

3. 发布配置 php artisan vendor:publish --tag=dev-tool-config

配置说明
====

[](#配置说明)

- 文件位置 config/dev-tool.php

```
 /**
     *  Model注解批量管理类
     */
    'model_annotation_helper' =>[
        'auto_model'=>[
            //自动注解的model
        ],
        'auto_dir'=>[
            //自动注解的目录
        ],
        'ignored_model'=>[
            //需要排除自动注解的model
        ],
        'ignored_dir'=>[
            //需要排除自动注解的model
        ],
    ],

```

运行命令
====

[](#运行命令)

- php artisan model-annotation-helper:generate --model="" //model参数填写 文件命名空间+类名

1. php artisan model-annotation-helper:generate //根据读取配置文件生产注解
2. php artisan model-annotation-helper:generate --model="" //根据读取配置文件+指定类生成注解
3. php artisan model-annotation-helper:generate --dir="" //根据读取配置文件+指定目录生成注解
4. php artisan model-annotation-helper:generate --dir="" --model="" //根据读取配置文件+指定目录生成注解+指定类生成注解
5. php artisan model-annotation-helper:generate --ignored-config=true --model="" --dir="" //忽略config配置只生成指定位置注解

注意事项
====

[](#注意事项)

1. 生成的注解中的类中如果不存在引入情况，不会自动添加
2. 每次扫描生成新的注解会兼容用户自定义的注释
3. 请勿提交composer.json

todo
====

[](#todo)

1. 兼容内网环境

openApi
=======

[](#openapi)

1. 同步机制大家需要把代码合并到开发分支避免版本冲突问题

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~12 days

Recently: every ~49 days

Total

17

Last Release

1428d ago

Major Versions

1.0.6 → v2.02021-12-07

2.5.0 → 3.0.22022-06-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c641d0b9a6fd466378686ddf17157b1e8c2a75c6b59a3c3ccadb2521c7d0ded?d=identicon)[guxiangming](/maintainers/guxiangming)

---

Tags

model ide

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dev-tool-laravel-dev-tool/health.svg)

```
[![Health](https://phpackages.com/badges/dev-tool-laravel-dev-tool/health.svg)](https://phpackages.com/packages/dev-tool-laravel-dev-tool)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[eliashaeussler/typo3-form-consent

Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form

1481.0k](/packages/eliashaeussler-typo3-form-consent)[ronasit/laravel-helpers

Provided helpers function and some helper class.

1475.7k13](/packages/ronasit-laravel-helpers)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)