Using Composer: PHP Package Management Explained 🚀

zeroexp.dev ZeroonLeave a Comment on Using Composer: PHP Package Management Explained 🚀
Using Composer: PHP Package Management Explained 🚀

Composer is the go-to dependency manager for PHP. If you’re still copy-pasting libraries manually, it’s time to level up your workflow! 💪

🎯 In this guide, you’ll learn:

✅ What Composer is and why you should use it
✅ How to install and configure Composer
✅ How to install and autoload PHP packages
✅ How to create your own Composer package
✅ A real-world mini project using Composer

Let’s dive in! 🚀

1️⃣ What is Composer?

💡 Composer is a dependency manager for PHP that automatically installs, updates, and loads packages (libraries) for your project.

🔥 Why use Composer?
✅ Manages dependencies easily
✅ Prevents compatibility issues
✅ Autoloads classes (No more require headaches!)
✅ Speeds up development

2️⃣ Installing Composer

✅ Installation on Windows

1️⃣ Download the Composer installer from getcomposer.org.
2️⃣ Run the installer and follow the instructions.
3️⃣ Open Command Prompt and verify installation:

composer -V

✅ Installation on macOS/Linux

Run the following command in the terminal:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Verify installation:

composer -V

You should see something like:

Composer version 2.x.x

3️⃣ Creating a New PHP Project with Composer

Let’s create a new project and manage dependencies using Composer.

1️⃣ Initialize a New Composer Project

Navigate to your project directory and run:

composer init

It will ask for details like:

  • Package name (zeroexp/dev-project)
  • Description (My first PHP project with Composer)
  • Author (Zero Dev <zero@zeroexp.dev>)
  • Minimum stability (stable)

At the end, Composer generates a composer.json file.

4️⃣ Installing PHP Packages with Composer

💡 Let’s install some useful packages using Composer!

Example 1: Installing a Logger (monolog/monolog)

composer require monolog/monolog

🔥 What happens?
✅ Downloads the monolog/monolog package from Packagist.
✅ Adds it to composer.json.
✅ Creates a vendor/ folder with all dependencies.

Using the Installed Package in PHP

<?php
require "vendor/autoload.php"; // Automatically loads installed packages

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger("app");
$log->pushHandler(new StreamHandler("app.log", Logger::WARNING));

$log->warning("This is a warning!");
$log->error("This is an error!");
?>

🔥 Why use vendor/autoload.php?
✅ Automatically loads all installed packages without requiring files manually.

5️⃣ Updating and Removing Packages

Update Packages to Latest Version

composer update

Remove a Package

composer remove monolog/monolog

🔥 What happens?
✅ Removes the package from composer.json and vendor/.

6️⃣ Using Composer Autoload for Your Own Classes

💡 You can also autoload your own PHP classes!

1️⃣ Create a Folder for Your Code

mkdir src

2️⃣ Create a Sample Class in src/Utils/Helper.php

<?php
namespace App\Utils;

class Helper {
    public static function greet($name) {
        return "Hello, $name!";
    }
}
?>

3️⃣ Configure Autoloading in composer.json

"autoload": {
    "psr-4": {
        "App\\": "src/"
    }
}

4️⃣ Run the Composer Dump-Autoload Command

composer dump-autoload

🔥 What happens?
✅ Generates vendor/autoload.php to automatically load classes.

5️⃣ Use Your Custom Class in index.php

<?php
require "vendor/autoload.php";

use App\Utils\Helper;

echo Helper::greet("Zero Dev");
?>

🔥 Boom! No more require statements! 🎉

7️⃣ Creating Your Own Composer Package

Want to share your code with the world? Create a public Composer package!

Step 1: Create a Package Directory

mkdir my-package && cd my-package
composer init

Step 2: Add Your Code (src/Calculator.php)

<?php
namespace MyPackage;

class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}
?>

Step 3: Configure Autoloading in composer.json

"autoload": {
    "psr-4": {
        "MyPackage\\": "src/"
    }
}

Step 4: Run composer dump-autoload

composer dump-autoload

Step 5: Test Your Package

<?php
require "vendor/autoload.php";

use MyPackage\Calculator;

$calc = new Calculator();
echo $calc->add(5, 10); // Output: 15
?>

🔥 Now your package is ready for Packagist! 🚀

8️⃣ Publishing Your Package to Packagist

💡 Want to make your package public?

1️⃣ Push your code to GitHub

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourusername/my-package.git
git push -u origin main

2️⃣ Submit your package to Packagist

  • Go to packagist.org
  • Submit your GitHub repository link
  • Run composer require yourname/my-package to install it! 🎉

🎯 Mini Project: Build a JSON API with Composer Packages

Let’s build a simple JSON API using Composer.

1️⃣ Install Dependencies

composer require slim/slim "^4.0"
composer require monolog/monolog

2️⃣ Create index.php

<?php
require "vendor/autoload.php";

use Slim\Factory\AppFactory;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$app = AppFactory::create();

$log = new Logger("api");
$log->pushHandler(new StreamHandler("api.log", Logger::INFO));

$app->get('/hello/{name}', function ($request, $response, $args) use ($log) {
    $log->info("Saying hello to " . $args['name']);
    $response->getBody()->write(json_encode(["message" => "Hello, " . $args['name']]));
    return $response->withHeader('Content-Type', 'application/json');
});

$app->run();
?>

3️⃣ Start the API Server

php -S localhost:8000

4️⃣ Test the API

Visit:

http://localhost:8000/hello/ZeroDev

💥 You just built an API using Composer! 🎉

🚀 Final Thoughts

Now you’re a Composer pro!
✅ Install and manage PHP packages
✅ Use Composer for autoloading
✅ Create and publish your own packages
✅ Build real-world projects with Composer

👉 Next: PHP and APIs

Happy coding! 🎉🚀

Leave a Reply