README

Generate a Postman Collection v2.1 from your Laravel API routes — with a single Artisan command.

Annotate your controllers with simple PHPDoc tags to control authentication, headers, descriptions, and even Postman pre-request and test scripts. The output is a ready-to-import JSON collection — no manual route copying, no drift between code and docs.

Features

• 🚀 One-command export — php artisan postman:export and you're done
• 🔐 Auth support — Bearer tokens, no-auth, parent-inherited, per-endpoint
• 📝 Rich annotations — descriptions, headers, scripts via standard PHPDoc
• 📂 External file sources — load descriptions and scripts from base_path() or resource_path()
• ⚡ Pre-request & test scripts — inject Postman JavaScript directly from your code
• 🎯 Folder grouping — collections organized by route prefix
• 🧩 Laravel 6 → 12 — broad compatibility, PHP 7.1+ through 8.x

Requirements

• PHP 7.1 or higher
• Laravel 6.x — 12.x

Installation

composer require oooiik/laravel-export-postman

Publish the config (optional):

php artisan vendor:publish --provider="Oooiik\LaravelExportPostman\ExportPostmanServiceProvider"

Quick Start

Export your routes to a Postman collection:

php artisan postman:export

The collection file will be created in your configured storage path. Import it into Postman → File → Import.

Configuration

Edit config/export-postman.php after publishing:

return [
    'name'        => env('APP_NAME', 'Laravel API'),
    'output_path' => storage_path('app/postman'),
    'base_url'    => env('APP_URL', 'http://localhost'),
    // ... and more
];

Annotation Reference

Add PHPDoc annotations to your controller methods or closures to enrich the generated collection.

Authentication

/**
 * @AuthBearer {{access_token}}
 */
public function show($id) { /* ... */ }

Headers

Use @Header key => value for custom request headers. Multiple @Header annotations are supported.

/**
 * @Header Accept => application/json
 * @Header X-Tenant-Id => {{tenant_id}}
 */
public function index() { /* ... */ }

Descriptions

Three flavors — inline, file from base_path(), file from resource_path(). They can be combined.

/**
 * @DescriptionContext Returns a paginated list of orders for the authenticated user.
 * @DescriptionResourcePath docs/api/orders-index.md
 */
public function index() { /* ... */ }

Pre-request Scripts

Inject Postman JavaScript that runs before the request is sent. Useful for token refresh, signature generation, or dynamic variables.

/**
 * @PreRequestScriptFileResourcePath postman/scripts/refresh-token.js
 */
public function transfer() { /* ... */ }

Test Scripts

Inject Postman JavaScript that runs after the response is received. Use for assertions or extracting values into environment variables.

/**
 * @TestScriptContext pm.test("Status 200", () => pm.response.to.have.status(200));
 */
public function login() { /* ... */ }

Full Example

/**
 * @AuthBearer {{access_token}}
 * @Header Accept => application/json
 * @Header X-Tenant-Id => {{tenant_id}}
 * @DescriptionContext Creates a new order for the authenticated user.
 * @DescriptionResourcePath docs/api/orders-create.md
 * @PreRequestScriptFileResourcePath postman/scripts/sign-request.js
 * @TestScriptContext pm.test("Created", () => pm.response.to.have.status(201));
 */
public function store(StoreOrderRequest $request)
{
    // ...
}

Compatibility Matrix

Contributing

Pull requests are welcome. For larger changes, please open an issue first to discuss the direction.

Feature ideas, bug reports, and questions → GitHub Issues.

Credits

• Obidjon Toshev — author & maintainer
• All contributors

License

The MIT License (MIT). See LICENSE for details.