PHPackages                             freema/n8n-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. freema/n8n-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

freema/n8n-bundle
=================

Symfony bundle for elegant integration with n8n workflow automation platform

2.0.1(1w ago)52.1k↓89.1%3MITPHPPHP ^8.2CI passing

Since Jul 13Pushed 1w agoCompare

[ Source](https://github.com/freema/symfony-n8n-bundle)[ Packagist](https://packagist.org/packages/freema/n8n-bundle)[ Docs](https://github.com/freema/symfony-n8n-bundle)[ RSS](/packages/freema-n8n-bundle/feed)WikiDiscussions main Synced yesterday

READMEChangelog (7)Dependencies (38)Versions (12)Used By (0)

Symfony N8n Bundle
==================

[](#symfony-n8n-bundle)

Elegant integration between Symfony applications and n8n workflow automation platform.

Features
--------

[](#features)

- **Type-safe communication** using PHP interfaces
- **UUID tracking system** for request/response pairing
- **Flexible communication modes**: Fire & Forget, Async with callback, Sync
- **Robust error handling** with retry and circuit breaker
- **Event-driven architecture** for monitoring and logging
- **Multi-instance support** for different environments
- **Dry run mode** for testing without actual sending

Requirements
------------

[](#requirements)

BundlePHPSymfony2.x8.2+ \*6.4, 7.x, 8.01.38.2+6.4, 7.x1.0–1.28.1+6.4, 7.0> \* Symfony 8.0 itself requires PHP 8.4+. On PHP 8.2/8.3 the bundle runs with Symfony 6.4 or 7.x; use PHP 8.4+ if you want Symfony 8.0.

Quick Start
-----------

[](#quick-start)

### 1. Installation

[](#1-installation)

```
composer require freema/n8n-bundle
```

### 2. Development with Docker and Taskfile

[](#2-development-with-docker-and-taskfile)

```
# Install Task (https://taskfile.dev)
brew install go-task/tap/go-task

# Initialize development environment
task init

# Start dev server
task serve

# Show available commands
task --list
```

### 3. Configuration

[](#3-configuration)

```
# config/packages/n8n.yaml
n8n:
  clients:
    default:
      base_url: 'https://your-n8n-instance.com'
      client_id: 'my-symfony-app'
      auth_token: '%env(N8N_AUTH_TOKEN)%'
      timeout_seconds: 30
      retry_attempts: 3
      enable_circuit_breaker: true
      proxy: '%env(HTTP_PROXY)%'  # Optional: HTTP proxy URL
      use_test_webhook: false  # Optional: use /webhook-test/ for unpublished workflows (default: false)
```

### 4. Entity Implementation

[](#4-entity-implementation)

```