This is a Laravel 4 Starter Site and it will help you getting started with Laravel 4. It's based off the great Laravel Starter Kit from brunogaspar, with some additional refinements, bugfixes, more secure defaults and a cleaner, more modern UX using Bootstrap 3.
It includes examples on how to use the framework itself and how to use some packages, like the awesome Sentry 2 package.
###Be sure to check out the full documentation site which has more in-depth installation and development details.
- Twitter Bootstrap 3.1.1
- jQuery 1.10.2
- Custom CLI Installer
- Translation-ready with localized language files
- Custom Error Pages:
- 403 for forbidden page access
- 404 for not found pages
- 500 for internal server errors
- 503 for the maintenance page
- Back-end
- User and Group management
- Manage blog posts and comments
- Login brute-force prevention via Sentry 2 - default lockout is 5 failed login attempts
- Front-end
- User login, registration, activation and forgot password
- User account area
- Blog functionality with comments
- Contact us page
- Packages included:
- PHP 5.3.7 or later
- MCrypt PHP Extension
git clone https://github.com/snipe/laravel4-starter your-folder
https://github.com/snipe/laravel4-starter/archive/master.zip
cd your-folder
curl -s http://getcomposer.org/installer | php
php composer.phar install
cd your-folder
composer install
Now that you have the Starter Kit cloned and all the dependencies installed, copy the file app/config/local/database.php.dist
to app/config/local/database.php
and update the settings to reflect your own database configuration.
Setup your mail settings by copying app/config/local/mail.php.dist
to app/config/local/mail.php
and update it with your own mail settings.
This will be used to send emails to your users, when they register and they request a password reset.
While testing locally, you can set 'pretend' => true,
in app/config/local/mail.php
to simulate email being sent if you don't have easy access to a mail server. (If you need an easy way to actually send test mails, SendGrid and Mandrill both offer free-tiered accounts.
Now, you need to create yourself a user and finish the installation.
Use the following command to create your default user, user groups and run all the necessary migrations automatically.
php artisan app:install
(Note that the Travis CI file skips this step and instead calls the individual setup methods and just inserts the example user, since the CI build isn't interactive.)
In dev mode, I use the fabulous Laravel Debugbar by @barryvdh. After you've installed/updated composer, you'll need to publish the assets for the debugbar:
php artisan debugbar:publish
The profiler is enabled by default if you have debug set to true in your app.php. You certainly don't have to use it, but it's pretty handy for troubleshooting queries, seeing how much memory your pages are using, etc.
To access the administration page, you just need to access http://your-host/admin
in your browser and it
will redirect you to the login page.
After being authenticated, you will be redirected back to the administration page.
The default Sentry setting is to lockout the user for 15 minutes after 5 failed login attempts. To
change these settings, edit your /vendor/cartalyst/sentry/src/config/config.php
file locally.
If you have questions about this project, you can reach me at snipe@snipe.net, or on Twitter at @snipeyhead.
Version 1, December 2009
Copyright (C) 2009 Philip Sturgeon email@philsturgeon.co.uk
Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.
DON'T BE A DICK PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
Do whatever you like with the original work, just don't be a dick.
Being a dick includes - but is not limited to - the following instances:
1a. Outright copyright infringement - Don't just copy this and change the name. 1b. Selling the unmodified original with no work done what-so-ever, that's REALLY being a dick. 1c. Modifying the original work to contain hidden harmful content. That would make you a PROPER dick.
-
If you become rich through modifications, related works/services, or supporting the original work, share the love. Only a dick would make loads off this work and not buy the original works creator(s) a pint.
-
Code is provided with no warranty. Using somebody else's code and bitching when it goes wrong makes you a DONKEY dick. Fix the problem yourself. A non-dick would submit the fix back.