https://github.com/simshaun/laravel-plant

Plant is a Laravel bundle that offers an easy way to seed your project with data using "seeds" (data fixtures). DISCLAIMER: This package is no longer maintained since Laravel came out with its own seeding mechanism.
https://github.com/simshaun/laravel-plant

Last synced: 10 months ago
JSON representation

Plant is a Laravel bundle that offers an easy way to seed your project with data using "seeds" (data fixtures). DISCLAIMER: This package is no longer maintained since Laravel came out with its own seeding mechanism.

• Host: GitHub
• URL: https://github.com/simshaun/laravel-plant
• Owner: simshaun
• Created: 2012-06-27T03:51:49.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2013-01-20T18:01:32.000Z (over 13 years ago)
• Last Synced: 2025-03-27T15:21:48.798Z (over 1 year ago)
• Language: PHP
• Homepage:
• Size: 146 KB
• Stars: 17
• Watchers: 2
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Plant

Plant is a bundle for Laravel that offers an easy way to seed your project and/or tests with data using "seeds".

Works well in combination with the excellent [Faker library](https://github.com/fzaninotto/Faker).

---

## Getting started

 1. Install by running `php artisan bundle:install plant`

 2. Enable the `plant` bundle in application/bundles.php

 3. Create a `seeds` folder in your application directory.

 4. Create seed files. For example:

        username = 'johndoe';

                $user->password = '12345678';

                $user->save();

                $user = new User;

                $user->username = 'janedoe';

                $user->password = '12345678';

                $user->save();

            }

            // This is optional. It lets you specify the order each seed is grown.

            // Seeds with a lower number are grown first.

            public function order()

            {

                return 100;

            }

        }

---

### Controlling the order that seeds are grown

Each seed class may contain an `order()` method that returns a sort order integer.

Seeds with a lower sort order are grown first.

---

## Growing Seeds

### All at once

run `php artisan plant::seed all`

#### Excluding seeds

You can exclude specific seeds from being grown by using the `--not` option.

Separate multiple exclusions with a comma.

e.g. `php artisan plant::seed all --not=users,posts`

### Multiple seeds (e.g. users,posts)

run `php artisan plant::seed users,posts`

 > Regardless of the order you list the seeds in the CLI command, Plant will always grow

 > them according to each seed's sort order.

### Individual seeds (e.g. users)

run `php artisan plant::seed users`

 > If multiple seeds with the same filename exist, they will all be grown.

 > This could happen when seeds are stored in bundles.

 > e.g. **application/seeds/users.php** and **bundles/plant/seeds/users.php**

 >

 > *Sort orders are still used.*

---

## References

If a seed needs to reference an object that was created in another seed,

use the references feature as shown below.

    username = 'johndoe';

            $user->password = '12345678';

            $user->save();

            $this->addReference('user-a', $user);

        }

        public function order()

        {

            return 100;

        }

    }

-

    user_id = $this->getReference('user-a')->id;

            $post->title = 'Lorem Ipsum Foo Foo';

            $post->save();

        }

        // This seed must be grown after the users seed

        // so that it can access the "user-a" reference.

        public function order()

        {

            return 200;

        }

    }

---

## Issues

If you find any bugs or have suggestions, please add them to the

[Issue Tracker](https://github.com/simshaun/laravel-plant/issues).