Hello Laravel Friends,
In thisblog, I will explain how to setup package development in Laravel.
Laravel Development Package allows developers to create reusable components that can be easily shared and integrated into Laravel applications. Whether you’re building utility libraries, integrating with third-party services, or extending Laravel’s core functionality, package development in Laravel offers a robust framework for building and distributing reusable components.
In this tutorial, we’ll walk through the process of creating a simple Laravel package step by step. Our package will be a basic utility for generating random strings. Let’s get started!
Contents
Steps to Create Laravel Package:
Step 1: Setting Up a New Package
First, let’s create a new Laravel package using the artisan command-line tool:
|
1 |
php artisan make:package Acme/RandomStringGenerator |
This command will generate the necessary directory structure for our package under packages/Acme/RandomStringGenerator.
Step 2: Writing Package Code
Navigate to the packages/Acme/RandomStringGenerator directory and create a new class for our random string generator.
|
1 2 |
mkdir src touch src/RandomStringGenerator.php |
Open RandomStringGenerator.php and add the following cod
|
1 2 3 4 5 6 7 8 9 10 11 |
<?php namespace Acme\RandomStringGenerator; class RandomStringGenerator { public static function generate($length = 10) { return substr(str_shuffle(str_repeat('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ', $length)), 0, $length); } } |
Step 3: Testing Your Package
Let’s write some tests to ensure our package works as expected. Create a new directory for tests and add a test file
|
1 2 |
mkdir tests touch tests/RandomStringGeneratorTest.php |
Open RandomStringGeneratorTest.php and add the following code
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
<?php namespace Acme\RandomStringGenerator\Tests; use PHPUnit\Framework\TestCase; use Acme\RandomStringGenerator\RandomStringGenerator; class RandomStringGeneratorTest extends TestCase { public function testRandomStringGenerator() { $string = RandomStringGenerator::generate(8); $this->assertEquals(8, strlen($string)); } } |
Run the tests using PHPUnit:
|
1 |
./vendor/bin/phpunit |
Step 4: Documenting Your Package
Generate API documentation for your package using Laravel Docs Generator:
|
1 |
php artisan make:docs |
This command will generate API documentation based on the PHPDoc comments in your code.
Step 5: Distributing Your Package
Publish your package to Packagist, the default package repository for Composer:
Create a composer.json file in the root of your package directory
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
{ "name": "acme/random-string-generator", "description": "A simple utility for generating random strings.", "type": "library", "license": "MIT", "authors": [ { "name": "Your Name", "email": "your@email.com" } ], "autoload": { "psr-4": { "Acme\\RandomStringGenerator\\": "src/" } }, "require": {} } |
- Commit your changes and push your package to a version control repository like GitHub.
- Register an account on Packagist (if you haven’t already) and submit your package’s GitHub repository URL.
- Once your package is published on Packagist, other developers can install it via Composer:
|
1 |
composer require acme/random-string-generator |
Conclusion
You’ve successfully created and distributed a Laravel package. Package development in Laravel offers a powerful way to encapsulate and share reusable components with the community. By following best practices and leveraging Laravel’s conventions and tools, you can create high-quality packages that streamline development tasks and accelerate project delivery.
Hire Laravel Developers for any customization requirement for your web application.
Happy Coding!
