How to Create and Publish a Composer Package for PHP

Step 1: Create Package Directory

In this step you create a directory to store your Composer package.

# Create a new directory for your package.
mkdir name-of-your-package
# Switch to that directory.
cd name-of-your-package

Initialize the Composer file with composer init and follow the prompts to set the package name, version, author, and description.

Package name

Package version

Package author

Package description

Step 2: Create Package Files

Create the source code for the package.

# Create the source code directory.
mkdir src
# Create a PHP file for the class.
touch src/HelloWorld.php

Edit src/HelloWorld.php and add the following class:

<?php

namespace YourVendor\HelloWorld;

class HelloWorld
{
    public function sayHello()
    {
        return 'Hello, World!';
    }
}

The class HelloWorld defines a sayHello() method that returns a simple greeting.

Step 3: Configure Autoloading

Add PSR‑4 autoloading information to composer.json so Composer can load classes from the src/ directory.

{
    "autoload": {
        "psr-4": {
            "YourVendor\\HelloWorld\\": "src/"
        }
    },
    "prefer-stable": true,
    "minimum-stability": "dev"
}

Run composer dump-autoload to generate the autoload.php file containing the package’s autoload information.

Step 4: Write Tests

Create a tests directory and add a PHPUnit test for the package.

mkdir tests
touch tests/HelloWorldTest.php

Edit tests/HelloWorldTest.php with the following content:

<?php

use YourVendor\HelloWorld\HelloWorld;
use PHPUnit\Framework\TestCase;

class HelloWorldTest extends TestCase
{
    public function testSayHello()
    {
        $helloWorld = new HelloWorld();
        $this->assertEquals('Hello, World!', $helloWorld->sayHello());
    }
}

Running the test should output OK (1 test, 1 assertion).

Step 5: Publish the Package

To make the package available to others, publish it on Packagist . Ensure you have a Packagist account, then submit the repository.

After publishing, the package can be required in other projects with:

composer require yourvendor/helloworld

Step 6: Local Testing in a Laravel Project

To test the package locally, add it as a path repository in your Laravel project's composer.json:

{
    "repositories": [
        {
            "type": "path",
            "url": "/path/to/HelloWorld"
        }
    ],
    "require": {
        "yourvendor/helloworld": "*"
    }
}

Replace /path/to/HelloWorld with the actual path, then run composer update to install the package.

Use the package in Laravel code:

<?php

use YourVendor\HelloWorld\HelloWorld;

$helloWorld = new HelloWorld();
echo $helloWorld->sayHello();

This basic example helps you get started; more advanced features such as configuration files, views, or migrations can be added as needed.