laris / cli
A supercharged Laravel development CLI tool for faster workflow
Requires
- php: ^8.2
- illuminate/filesystem: ^10.20|^11.0|^12.0
- illuminate/support: ^10.20|^11.0|^12.0
- laravel/prompts: ^0.1.18|^0.2.0|^0.3.0
- symfony/console: ^6.2|^7.0
- symfony/polyfill-mbstring: ^1.31
- symfony/process: ^6.2|^7.0
Requires (Dev)
- phpunit/phpunit: ^12.1
- squizlabs/php_codesniffer: ^3.7
README
_____ _____ _____ _____ _____
/\ \ /\ \ /\ \ /\ \ /\ \
/::\____\ /::\ \ /::\ \ /::\ \ /::\ \
/:::/ / /::::\ \ /::::\ \ \:::\ \ /::::\ \
/:::/ / /::::::\ \ /::::::\ \ \:::\ \ /::::::\ \
/:::/ / /:::/\:::\ \ /:::/\:::\ \ \:::\ \ /:::/\:::\ \
/:::/ / /:::/__\:::\ \ /:::/__\:::\ \ \:::\ \ /:::/__\:::\ \
/:::/ / /::::\ \:::\ \ /::::\ \:::\ \ /::::\ \ \:::\ \:::\ \
/:::/ / /::::::\ \:::\ \ /::::::\ \:::\ \ ____ /::::::\ \ ___\:::\ \:::\ \
/:::/ / /:::/\:::\ \:::\ \ /:::/\:::\ \:::\____\ /\ \ /:::/\:::\ \ /\ \:::\ \:::\ \
/:::/____/ /:::/ \:::\ \:::\____\/:::/ \:::\ \:::| |/::\ \/:::/ \:::\____\/::\ \:::\ \:::\____\
\:::\ \ \::/ \:::\ /:::/ /\::/ |::::\ /:::|____|\:::\ /:::/ \::/ /\:::\ \:::\ \::/ /
\:::\ \ \/____/ \:::\/:::/ / \/____|:::::\/:::/ / \:::\/:::/ / \/____/ \:::\ \:::\ \/____/
\:::\ \ \::::::/ / |:::::::::/ / \::::::/ / \:::\ \:::\ \
\:::\ \ \::::/ / |::|\::::/ / \::::/____/ \:::\ \:::\____\
\:::\ \ /:::/ / |::| \::/____/ \:::\ \ \:::\ /:::/ /
\:::\ \ /:::/ / |::| ~| \:::\ \ \:::\/:::/ /
\:::\ \ /:::/ / |::| | \:::\ \ \::::::/ /
\:::\____\ /:::/ / \::| | \:::\____\ \::::/ /
\::/ / \::/ / \:| | \::/ / \::/ /
\/____/ \/____/ \|___| \/____/ \/____/
๐ฅ What the Heck is Laris?
Laris is not just another CLI toolโitโs your Laravel Artisan on steroids ๏ฟฝ๐.
Tired of typing php artisan a million times a day?
Annoyed by forgetting command syntax right after you Google it?
Wish you had a smarter, faster, cooler way to manage Laravel projects?
Enter Laris.
Itโs like if Artisan had a caffeine overdose and decided to automate your life.
๐ Why Laris is the GOAT (Greatest Of All Time)
โ
Shorter Commands โ laris instead of php artisan (because laziness = efficiency).
โ
Project Switching โ Jump between Laravel projects like a multitasking wizard.
โ
Database Magic โ Run queries, fake data, and play God with your DB.
โ
Deploy Like a Pro โ One command to push, migrate, and flex.
โ
Git & Composer Shortcuts โ Because typing git push origin main is so 2020.
โ
Backup & Docs โ Automate boring stuff before you forget.
โ
Extensible AF โ Add your own commands and make it yours.
โก Laris in Action: The Cheat Sheet
| Command | What It Does (Because Youโre Too Lazy to Guess) |
|---|---|
laris list |
Lists all commands (duh) |
laris select |
Switch between Laravel projects like a boss |
laris db list-tables |
Shows all DB tables (so you can judge them) |
laris db select users |
Runs SELECT * FROM users (but fancier) |
laris db fake-data |
Fill your DB with beautiful lies (seeding) |
laris backup run |
Backs up your project (before you break it) |
laris deploy |
Deploys with one keystroke (no excuses now) |
laris git push |
Pushes to Git without typing the whole thing |
laris npm run dev |
Runs npm because frontend is hard |
laris docs generate |
Generates docs (so you donโt have to) |
๐ Installation: Get Laris in 3 Seconds
Option 1: The "Iโm in a Hurry" Method
composer global require laris/cli
Option 2: The "Iโm in a Hurry" Method
git clone https://github.com/itashia/laris-cli.git && cd laris
Option 3: The "I Like Aliases" Method
Add this to your .bashrc or .zshrc:
alias laris='php /path/to/laris/src/Application.php'
Option 4: The "I Want Global Access" Method
Symlink it to /usr/local/bin (for ultimate power):
ln -s /path/to/laris/src/Application.php /usr/local/bin/laris
Now just type laris anywhere, anytime.
๐ฎ Usage: How to Not Screw It Up
- Navigate to a Laravel project (or use
laris selectto pick one). - Run commands like a pro:
laris db list-tables # See whatโs in your DB laris db fake-data # Fill it with nonsense laris deploy # Ship it!
- Profit. ๐ฐ
๐งโ๐ป For Nerds Who Love Code
Laris is built with:
- Pure PHP OOP (because weโre not animals)
- Modular Commands in
src/Commands/(add your own!) - DB Helpers in
src/Library/DB/(SQL without the pain) - Concerns for Reusable Logic (DRY is life)
Want to add a command? Just drop a new class in src/Commands/.
๐ค Contribute (Because Sharing is Caring)
- Fork it
- Add a cool feature
- Submit a PR
- Brag about it on Twitter
๐ License
MIT. Do whatever. Just donโt blame us if your DB explodes.
๐ค Final Words
Laris exists because typing php artisan is a crime against productivity.
Now go automate your workflow, impress your coworkers, and spend more time drinking coffee.
Happy coding! ๐๐ฅ
(P.S. If you break something, just run laris backup run first. Youโre welcome.)
Need more details? Check the docs/ folder or yell at us on GitHub. ๐ค๐ฌ