edrands/laravel-seeder

The Enhanced Laravel Project Seeder gets new Laravel projects up-and-running fast. Features self-contained testing (no pear or global testing package required).

DEPRECATED — Enhanced Laravel Project Seeder

This project is no longer supported. Since a few people have starred, watched and forked this repo, I won't just outright remove it for now., _(*1)

While not a free replacement, if you're looking for a way to quickly start a new Laravel project, try Laravel Spark., _(*2)

, _(*3)

About the Enhanced Laravel Project Seeder

After starting a few projects with Laravel, I realized I was repeating myself a lot in my first few steps, setting up the same things just to get going. This project is meant to alleviate that problem, so I can get rolling on the actual project fast., _(*4)

This package is not meant to be a dependency for other projects. It's meant to be used with Composer's create-project command., _(*5)

This is meant mostly for my benefit, and in some regards is highly opinionated. But if it's helpful to you, you're welcome to start your own Laravel based projects with it, or fork it and customize it to your needs., _(*6)

There's a significant change to the layout from the base Laravel install. In anticipation of making more advanced projects, I've started following more advanced practices that involve breaking things up far beyond the basic MVC layout. Most of the files have moved out of the app directory into src. Everything is namespaced, and seperated into composers, observers, repositories, and lots of other parts. I've mostly followed the first part of Dayle Rees' "Breaking the Mold"., _(*7)

What's In This Thing

Laravel, of course. Wouldn't be much of a Laravel project seeder without that. It's version 4.2 right now., _(*8)

Lots of projects use Bootstrap for their front end framework, so version 3.1 of that is included. Also included is Bootstrapper, a Laravel way to generate Bootstrap compatible markup. handy for complex things like menus., _(*9)

Icons. Lots of icons via Font Awesome v4.1. 439 at last count., _(*10)

Testing is important, if for no other reason than the developer's peace of mind. Therefore the seeder includes Codeception framework and Mockery. These tools make testing easier, almost fun, and therefore more likely testing will actually happen., _(*11)

Continuous integration is a great way to automate testing and maintenance. Configuration files for several CI services are included. Travis runs all the tests on push and pull requests. Scrutinizer runs a variety of scripts to check your code for security holes, sloppy code, and coding style problems. Keep in mind you still need to turn each service on for your project., _(*12)

IDEs and code editors don't really understand the Laravel facade system, and so they have trouble giving you code suggestions and documentation for a lot of Laravel's functionality. To compensate for this, the Laravel IDE Helper Generator is included. Each time you update in Composer, a helper file is generated that your editor can understand., _(*13)

Laravel 4 Debugbar is enabled in the development environment to provide information overload about what's happening when you load a page., _(*14)

To help help speed up workflow, there's also Jeffrey Way's generators., _(*15)

I currently use NetBeans as my IDE, so the files for a NetBeans PHP project come along too., _(*16)

Installing

Composer must be installed on your system in order for this to work. But if you're working with Laravel, you probably have it installed all ready anyway., _(*17)

1. Open a command prompt in the directory where you keep your projects. For example, I'm running Windows and use c:\development
2. Now run composer create-project edrands/laravel-seeder project-name replacing project-name with the name of the directory for all your project's file. This must be a non-existent or empty directory.
3. Wait while Composer automatically downloads the seed, installs all the dependencies, generates an IDE code completion helper, and generates a random hashing key.
4. Follow the steps in todo.md in the root directory of your new project.
5. Get working on the specifics of your project.

Contributing

If you'd like to contribute to this project, you can help in the typical GitHub way., _(*18)

Issues and pull requests should be filed on the edrands/laravel-seeder repository., _(*19)

Please keep in mind that since this seed is meant for the way I work, if you'd like customizations specific to the way you work, your best option is to fork this project and modify from there., _(*20)

If your issue or pull request is related to Laravel itself, please see below about how to contribute to Laravel., _(*21)

License

The Enhanced Laravel Project Seeder is open-sourced software licensed under the MIT license, _(*22)

About Laravel

, _(*23)

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable, creative experience to be truly fulfilling. Laravel attempts to take the pain out of development by easing common tasks used in the majority of web projects, such as authentication, routing, sessions, and caching., _(*24)

Laravel aims to make the development process a pleasing one for the developer without sacrificing application functionality. Happy developers make the best code. To this end, we've attempted to combine the very best of what we have seen in other web frameworks, including frameworks implemented in other languages, such as Ruby on Rails, ASP.NET MVC, and Sinatra., _(*25)

Laravel is accessible, yet powerful, providing powerful tools needed for large, robust applications. A superb inversion of control container, expressive migration system, and tightly integrated unit testing support give you the tools you need to build any application with which you are tasked., _(*26)

Official Documentation

Documentation for the entire framework can be found on the Laravel website., _(*27)

Contributing To Laravel

All issues and pull requests should be filed on the laravel/framework repository., _(*28)

License

The Laravel framework is open-sourced software licensed under the MIT license, _(*29)

Example Readme:

You can delete from here up for your project's readme., _(*30)

Project Title

About

A description of this project, what it's about, what it does, how it works and why the reader should care., _(*31)

Technologies

• PHP 5.4+
• Laravel Framework

Standards

Work on this project should strive to adhere to the following standards and models:, _(*32)

• Semantic Versioning v2.*

License

This project is open-sourced software licensed under the MIT license, _(*33)

Portions of this project may be subject to other copyrights and licenses., _(*34)