PHPackages                             amicrud/search - 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. [Search & Filtering](/categories/search)
4. /
5. amicrud/search

ActiveLibrary[Search & Filtering](/categories/search)

amicrud/search
==============

Search for a method, class, or variable in the project using artisan command

v1.1.51(1mo ago)1265MITPHPPHP >=7.4

Since Dec 29Pushed 1mo agoCompare

[ Source](https://github.com/amicrud/search)[ Packagist](https://packagist.org/packages/amicrud/search)[ RSS](/packages/amicrud-search/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (3)Versions (13)Used By (0)

AmiCrud Search
==============

[](#amicrud-search)

Search for classes, methods, variables, Blade views, and frontend UI code from an Artisan command.

Features
--------

[](#features)

- Search across common Laravel and PHP project files.
- Supports Blade, PHP, JavaScript, TypeScript, Vue, CSS, JSON, YAML, Markdown, XML, and env files by default.
- Works with Inertia applications where UI code lives in `resources/js`.
- Excludes `vendor`, `storage`, `node_modules`, `.git`, and generated build folders by default.
- Can optionally replace matched text in all matched files.
- Built with command, action, service, and DTO layers for maintainable package code.

Installation
------------

[](#installation)

You can install the package via Composer. Run the following command in your Laravel project:

```
composer require amicrud/search
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
php artisan amicrud:search UserController
```

Use quotes when searching strings with spaces:

```
php artisan amicrud:search 'Create Account'
```

### Search A Specific Path

[](#search-a-specific-path)

```
php artisan amicrud:search Dashboard --path=resources/js
```

### Include Vendor Or Storage

[](#include-vendor-or-storage)

```
php artisan amicrud:search SomeClass --vendor
php artisan amicrud:search failed-job --storage
```

### Search Specific Extensions

[](#search-specific-extensions)

```
php artisan amicrud:search Dashboard --extensions=js,jsx,ts,tsx,vue
```

### Replace Matches

[](#replace-matches)

```
php artisan amicrud:search oldName --replace=newName
```

Replacement runs once per matched file and updates every occurrence of the keyword in that file.

Testing
-------

[](#testing)

Run the test suite with Composer:

```
composer test
```

The tests cover searching backend PHP files, Blade views, Inertia frontend files in `resources/js`, excluded directories, custom extensions, and replacement behavior.

Releasing
---------

[](#releasing)

If the latest GitHub tag is `v1.1.30`, the next feature release should be:

```
git add .gitignore README.md composer.json phpunit.xml src tests
git commit -m "Improve project search architecture"
git tag v1.2.0
git push origin main
git push origin v1.2.0
```

Use a patch tag such as `v1.1.31` only for small bug fixes. Use a minor tag such as `v1.2.0` when adding new behavior, like frontend file searching or a new test suite.

Testing
-------

[](#testing-1)

Run the test suite with Composer:

```
composer test
```

Run the suite with a text coverage report:

```
composer test:coverage
```

Publishing A Release
--------------------

[](#publishing-a-release)

Create a GitHub repository, then connect and push this package:

```
git init
git add .
git commit -m "Initial release"
git branch -M main
git remote add origin git@github.com:YOUR_USERNAME/search.git
git push -u origin main
```

Create and push a version tag:

```
git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0
```

For future releases, commit your changes, then create a new semantic version tag such as `v1.0.1`, `v1.1.0`, or `v2.0.0`.

Contributing
------------

[](#contributing)

Contributions are welcome. Please follow these steps before opening a pull request:

1. Fork the repository.
2. Clone your fork locally.
3. Create a new branch for your change.
4. Install dependencies with Composer.
5. Make your changes.
6. Add or update tests for any behavior you change.
7. Run the test suite.
8. Open a pull request into the `main` branch.

```
git clone git@github.com:YOUR_USERNAME/search.git
cd search
composer install
git checkout -b feature/your-change
composer test
```

Keep pull requests focused, describe what changed, and include any relevant test details.

Support
-------

[](#support)

If you encounter any problems or have questions, please open an issue on the GitHub repository.

License
-------

[](#license)

The AmiCrud package is open-sourced software licensed under the MIT license.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance90

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~83 days

Recently: every ~101 days

Total

12

Last Release

49d ago

PHP version history (2 changes)v1.0.0PHP ^8.0

v1.0.16PHP >=7.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/33376436?v=4)[Emmanuel Amissah](/maintainers/focuslegon)[@focuslegon](https://github.com/focuslegon)

---

Top Contributors

[![focuslegon](https://avatars.githubusercontent.com/u/33376436?v=4)](https://github.com/focuslegon "focuslegon (12 commits)")

---

Tags

phpsearchlaravelartisaninertia

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/amicrud-search/health.svg)

```
[![Health](https://phpackages.com/badges/amicrud-search/health.svg)](https://phpackages.com/packages/amicrud-search)
```

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k212.4M1.5k](/packages/laravel-sail)[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M322](/packages/laravel-ai)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

79227.1M228](/packages/laravel-mcp)[propaganistas/laravel-disposable-email

Disposable email validator

6023.2M7](/packages/propaganistas-laravel-disposable-email)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

731189.9k16](/packages/tallstackui-tallstackui)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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