About Laravel
Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
- Simple, fast routing engine.
- Powerful dependency injection container.
- Multiple back-ends for session and cache storage.
- Expressive, intuitive database ORM.
- Database agnostic schema migrations.
- Robust background job processing.
- Real-time event broadcasting.
Laravel is accessible, powerful, and provides tools required for large, robust applications.
Learning Laravel
Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.
You may also try the Laravel Bootcamp, where you will be guided through building a modern Laravel application from scratch.
If you don't feel like reading, Laracasts can help. Laracasts contains over 2000 video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
Building this project locally
Following the quick start guide, I took a few shorcuts to provide developers with a fast an easy experience locally.
- Clone the project anywhere on your local machine.
- Make sure docker desktop and deamon are installed and avaliable. Make sure to
cd LaravelGithubAPI
everthing else is run from whithin that directory. - Then create a
.env
file at the root of the folder and add the enviroment variables (super important or it might not work). Most variables are what you get from the quickstarted execept for one GITHUB_TOKEN. Either you use someone's token or create your own. Without it the authetication will fail. - Run the folowing command
curl -s "https://gist.githubusercontent.com/bmartinez287/61e647924bfd89739407f151bf5cff58/raw/02be39ff2c1de9870d2d6cf50eb40cc8cc02f5ec/laravel.build" | bash
This command was inspired by laravel's own https://laravel.build/example-app - Now its time to run
./vendor/bin/sail up
- As noted on the quick start, that command can be alias so its easier to run.
- If everything is running we can hit localhost and see the stantard laravel welcome screen.
- Then we must run
./vendor/bin/sail artisan migrate:refresh --seed
this command will preload the database with the search api query from github and create our custom table. - Then we can go to localhost/vanderbilt and see our website in action.
- To see more details about each item click on the title.
- To load a fresh set of data click on the reload button.
Common error
If you did a ./vendor/bin/sail up
before adding the .env
file you likely break the connection to the database. To restore it delete the mysql volume inside of docker desktop add the .env
file with the variables and ./vendor/bin/sail up
.
License
The pet project is open-sourced software licensed under the MIT license.