Download the PHP package mohamed-ayman/laravel-postman-generator without Composer

Laravel Postman Generator

A professional Laravel package that automatically generates Postman collections from your Laravel routes, controllers, validation rules, and middleware. This package scans your entire Laravel project and creates a complete Postman collection with all the necessary information.

Features

✨ Comprehensive Route Scanning

• Automatically scans all Laravel routes
• Supports web, API, and custom route groups
• Configurable route inclusion/exclusion

🔍 Deep Controller Analysis

• Extracts controller methods and parameters
• Identifies Form Request classes
• Analyzes method signatures and dependencies

✅ Validation Rule Extraction

• Extracts validation rules from Form Requests
• Finds custom validation in controllers
• Generates example request bodies based on validation rules

🛡️ Middleware Analysis

• Detects authentication middleware (Sanctum, Passport, etc.)
• Extracts required headers from middleware
• Identifies CSRF protection and other security middleware

📦 Postman Collection Generation

• Generates complete Postman Collection v2.1.0 JSON
• Organizes routes into folders by path structure
• Includes variables for base URL and authentication tokens
• Adds default headers and authentication configuration

🌐 Postman API Integration

• Update existing Postman collections via API
• Create new collections programmatically
• Sync your Laravel API documentation automatically

Installation

From Packagist (After Publishing)

Once the package is published on Packagist, you can install it via Composer:

From GitHub (Before Publishing)

If the package is not yet on Packagist, add the GitHub repository to your composer.json:

Then run:

Troubleshooting

If you encounter security advisories or installation issues, see INSTALLATION_TROUBLESHOOTING.md for solutions.

The package will automatically register its service provider.

Configuration

Publish the configuration file:

This will create a config/postman-generator.php file where you can configure:

• Base URL for your API
• Collection name and description
• Output path for the generated JSON file
• Routes to include/exclude
• Postman API credentials (for API updates)

Usage

Basic Usage

Generate a Postman collection from your Laravel routes:

This will create a Postman collection JSON file at the configured output path (default: storage/app/postman-collection.json).

Advanced Usage

Custom Output Path

Custom Collection Name

Custom Base URL

Include Specific Routes

Or include all routes:

Exclude Routes

Update Postman Collection via API

First, configure your Postman API key and collection ID in the config file or environment:

Then run:

Programmatic Usage

You can also use the package programmatically:

How It Works

Route Scanning

The package scans all registered Laravel routes and extracts:

• URI patterns
• HTTP methods
• Route names
• Controller classes and methods
• Middleware stack
• Route parameters

Controller Analysis

For each controller method, the package:

• Uses reflection to analyze method signatures
• Identifies Form Request classes
• Extracts method parameters and types
• Reads docblocks for additional information

Validation Extraction

The package extracts validation rules from:

1. Form Request Classes: Reads the rules() method
2. Controller Methods: Parses $request->validate() calls
3. Validator Facade: Finds Validator::make() calls

Middleware Analysis

The package analyzes middleware to:

• Detect authentication requirements
• Extract required headers (Authorization, CSRF tokens, etc.)
• Identify custom middleware data requirements

Collection Generation

The generated Postman collection includes:

• All routes organized by path structure
• Request methods and URLs
• Request bodies with example data based on validation rules
• Required headers from middleware
• Route parameters as variables
• Authentication configuration
• Environment variables for base URL and tokens

Example Generated Collection Structure

Requirements

• PHP >= 8.2
• Laravel >= 11.0
• Guzzle HTTP Client (for Postman API integration)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

The MIT License (MIT). Please see License File for more information.

Author

Mohamed Ayman

Support

If you encounter any issues or have questions, please open an issue on GitHub.

Repository

GitHub Repository

Changelog

Please see CHANGELOG for more information on what has changed recently.