## Chapter 19: Composer - Your PHP Shopping Mall for Code! **Composer is like a shopping mall for PHP code - you can pick and choose the best libraries without writing everything yourself!** **Think of Composer as your personal shopping assistant - it finds, downloads, and organizes all the code libraries you need!** ### What is Composer? - The Shopping Mall Analogy **Before Composer (The Hard Way):** ``` Manual Library Management: 1. Google "PHP email library" 2. Download random ZIP file 3. Extract to random folder 4. Manually include files: require 'some/path/email.php' 5. Hope it works with your PHP version 6. Repeat for every library! ``` **With Composer (The Smart Way):** ``` Composer Shopping Experience: 1. composer require phpmailer/phpmailer 2. Composer downloads everything automatically 3. Autoloading works instantly 4. Version conflicts are handled for you 5. Updates are one command away! ``` ### Installing Composer - Your Shopping Assistant Setup **Installing Composer is like installing a shopping app on your phone - do it once, use it forever!** **Windows (The Easy Way):** 1. Download Composer-Setup.exe from getcomposer.org 2. Run the installer (it's like installing any app) 3. Open Command Prompt and type: `composer -V` 4. If you see a version number, you're ready to shop! **macOS/Linux (The Terminal Way):** ```bash # Copy-paste this command (it's safe!) curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer # Test your installation composer -V ``` ### Your First Composer Project - Building Your Shopping List **Creating a new project is like starting a new shopping list - organized and purposeful!** **Step 1: Create Your Project Folder** ```bash # Make a new folder for your project mkdir my-awesome-project cd my-awesome-project # Initialize Composer (like creating a shopping list) composer init ``` **Step 2: Answer the Questions (Don't Overthink It!)** ``` Package name: my-vendor/my-project Description: My awesome PHP project Author: Your Name <your.email@example.com> Minimum Stability: stable Package Type: project License: MIT Would you like to define your dependencies now? no Would you like to define your dev dependencies now? no ``` **What Just Happened?** - Composer created a `composer.json` file (your shopping list) - This file remembers all your libraries and versions - It's like a recipe that tells Composer exactly what you need! ### Adding Your First Library - Time to Go Shopping! **Adding a library is as easy as adding items to your cart!** **Let's Add a Popular Email Library:** ```bash # Add PHPMailer (super popular email library) composer require phpmailer/phpmailer ``` **What Composer Does Automatically:** ``` Composer's Magic: 1. Downloads PHPMailer to vendor/ folder 2. Updates composer.json with the version 3. Creates composer.lock (locks exact versions) 4. Sets up autoloading automatically 5. Your code can use PHPMailer immediately! ``` **Your Project Structure After Composer:** ``` my-awesome-project/ ├── composer.json ← Your shopping list ├── composer.lock ← Exact versions (don't edit!) ├── vendor/ ← All downloaded libraries │ ├── autoload.php ← Magic autoloader │ └── phpmailer/ ← PHPMailer files └── index.php ← Your code goes here ``` ### Autoloading Magic - No More Manual Includes! **Autoloading is like having a personal assistant who finds and brings you things automatically!** **The Old Way (Manual Including):** ```php <?php // The painful way - manually include every file! require 'lib/database.php'; require 'lib/user.php'; require 'lib/email.php'; require 'vendor/phpmailer/src/PHPMailer.php'; require 'vendor/phpmailer/src/SMTP.php'; // ... and 50 more files! ?> ``` **The Composer Way (Autoloading):** ```php <?php // Just include the autoloader once! require 'vendor/autoload.php'; // Now you can use ANY library automatically! use PHPMailerPHPMailerPHPMailer; $mail = new PHPMailer(); // Composer loads it automatically! ?> ``` ### Organizing Your Own Code - PSR-4 Autoloading **PSR-4 autoloading is like having organized shelves in your kitchen - everything has its place!** **The Clean Setup:** 1. **Create your source folder:** `mkdir src` 2. **Add PSR-4 autoloading to composer.json:** ```json { "name": "my-vendor/my-project", "autoload": { "psr-4": { "App\": "src/" } } } ``` **Your Folder Structure:** ``` my-awesome-project/ ├── composer.json ├── src/ ← Your code goes here │ ├── Models/ │ │ └── User.php ← AppModelsUser class │ └── Services/ │ └── EmailService.php ├── vendor/ ← Composer libraries └── index.php ``` **Example: Creating Your First Autoloaded Class** ```php <?php // src/Services/EmailService.php namespace AppServices; use PHPMailerPHPMailerPHPMailer; class EmailService { public function sendWelcomeEmail(string $email): bool { $mail = new PHPMailer(); $mail->addAddress($email); $mail->Subject = "Welcome!"; $mail->Body = "Thanks for joining us!"; return $mail->send(); } } ?> ``` **Using Your Autoloaded Class:** ```php <?php // index.php require 'vendor/autoload.php'; use AppServicesEmailService; $emailService = new EmailService(); $emailService->sendWelcomeEmail("user@example.com"); ?> ``` **After adding new classes, run:** ```bash composer dump-autoload ``` ### Common Composer Commands - Your Shopping Assistant Commands | Command | What It Does | When to Use | |---------|---------------|-------------| | `composer require package/name` | Add a new library | When you need new functionality | | `composer update` | Update all libraries | When you want latest versions | | `composer install` | Download all dependencies | When setting up existing project | | `composer dump-autoload` | Refresh autoloader | After adding new classes | | `composer remove package/name` | Remove a library | When you don't need it anymore | ### Real-World Example: Building a Complete Project **Let's build a simple contact form that sends emails:** **Step 1: Create Project and Add Dependencies** ```bash mkdir contact-form cd contact-form composer init # Answer the questions composer require phpmailer/phpmailer ``` **Step 2: Create Your Code Structure** ```php <?php // src/Services/ContactService.php namespace AppServices; use PHPMailerPHPMailerPHPMailer; class ContactService { public function sendContactEmail(string $name, string $email, string $message): bool { $mail = new PHPMailer(); $mail->setFrom($email, $name); $mail->addAddress("admin@example.com"); $mail->Subject = "Contact Form: {$name}"; $mail->Body = $message; return $mail->send(); } } ?> ``` **Step 3: Update composer.json for Autoloading** ```json { "name": "my-company/contact-form", "autoload": { "psr-4": { "App\": "src/" } }, "require": { "phpmailer/phpmailer": "^6.6" } } ``` **Step 4: Create Your Main File** ```php <?php // public/index.php require '../vendor/autoload.php'; use AppServicesContactService; if ($_POST) { $contactService = new ContactService(); $success = $contactService->sendContactEmail( $_POST['name'], $_POST['email'], $_POST['message'] ); echo $success ? "Email sent!" : "Failed to send email"; } ?> <form method="POST"> <input name="name" placeholder="Your Name" required> <input name="email" type="email" placeholder="Your Email" required> <textarea name="message" placeholder="Your Message" required></textarea> <button type="submit">Send</button> </form> ``` **Step 5: Run Composer Commands** ```bash composer dump-autoload # Refresh autoloader php -S localhost:8000 -t public # Start development server ``` ### Common Composer Mistakes and How to Fix Them | Mistake | What Happens | How to Fix | |---------|---------------|------------| | Forgetting `composer install` | "Class not found" errors | Run `composer install` first | | Editing composer.lock manually | Version conflicts | Let Composer manage this file | | Not committing composer.json | Team members can't install | Always commit composer.json | | Forgetting `dump-autoload` | New classes not found | Run `composer dump-autoload` | | Using `composer update` carelessly | Breaking changes | Use `composer require` with specific versions | **Pro Tips:** - **Always commit composer.json** (your shopping list) - **Never commit vendor folder** (it's like committing your groceries!) - **Use specific versions** in production: `composer require package/name:1.2.3` - **Read the documentation** of libraries you use **Remember:** Composer is your friend - it makes PHP development much easier and more professional! ---