Download the PHP package caneco/artisan-aliases without Composer

--- # Laravel Artisan Aliases If you live in the command it's always good to save some keystrokes, specially for commands that you keep typing. This package will help you create alias for you artisan commands, and more.. ## Installation You can install the package via composer: #### Registering the service provider In Laravel 5.5 the service provider will automatically get registered. But if needed just add the service provider in `config/app.php` file: #### Publishing the package assets To publish the configuration file and `.laravel_alias`, execute the following command and pick this Service Provider: Or do it in a single command: When published, this is the contents of the config file: ## Usage After publishing the initial files, your alias will be stored folder locally in the application directory; or globally in your home directory. And like any other bash alias file the contents will have following format: #### Listing existing alias To list the current alias available you can run the following command: Also, the available alias in appear on your artisan command list: #### Adding new alias Add your alias directly in the file `.laravel_alias`, or just use the artisan command: And, if you pass the `--global` option the alias will be registered instead in the `.laravel_alias` of your home directory. If you dont pass the required arguments the `--list` option will be triggered, and you will be presented with the command info; usage; and list of alias available. #### Comments Anything after the character `#` it's considered a comment and will be not considered for execution. #### Quote surrounding Surrounding the command with quotes are not mandatory, but if the command to be aliased has some spaces you must use them. #### Multiple commands An alias can have multiple commands associated by using the operators `&&` or `||`. And, just like bash, when using `&&` the sequence of the commands will terminate if one of them returns a value bigger than zero. While the `||` will continue no matter what. #### Shell commands If you prefix your alias with an exclamation point, will be treated as a shell command. #### Alias*ception…* Yes, you can also create alias of alias... #### Artisan groups If you set your alias with a namespace like `boot:tables` or `boot:cache`, Artisan list will group your alias toghether. ## Gotchas ⚠️ - Currently, to modify or delete any alias you need to open the `.laravel_aliases` and do it manually but it's planned to have a way of doing from the terminal. - Adding an alias with the same name as other it will result with an exception. - Having two alias manually defined in the `.laravel_aliases` the last alias command will prevail. - An alias with the same name as an Artisan command, the Artisan prevail. ## Supported versions Look at the table below to find out what versions of Laravel are supported on what version of this package: Laravel Framework | Artisan Alias :--- | :--- `5.7.*` | `^1.0` ## Road map Artisan Alias is stable but there is still some things that I would like to add in the package. Here's the plan for what's coming: - [ ] Remove an existing alias using the option `--d|delete` - [ ] Firing a `@handle` method if alias has a `::class` reference - [ ] Alert the user try to add an alias with `sudo` in the command **(usefull?)** - [ ] Add comments - [x] Allow to replace an existing alias using the option `--force` - [x] Add tests ## Contributing All contributions (pull requests, issues and feature requests) are welcome. Make sure to read through the [Contributing file](/caneco/artisan-alias/blob/master/CONTRIBUTING.md) first, though. See the [contributors page](/caneco/artisan-aliases/graphs/contributors) for all contributors. ## License The MIT License (MIT). Please see [License File](/caneco/artisan-alias/blob/master/LICENSE.md) for more information.