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

1.3.0(4mo ago)42.0k↓56.3%2[1 PRs](https://github.com/freema/symfony-n8n-bundle/pulls)MITPHPPHP ^8.2CI passing

Since Jul 13Pushed 4mo agoCompare

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

READMEChangelog (5)Dependencies (19)Versions (10)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)

VersionPHPSymfony1.3+^8.26.4, 7.x1.3+^8.48.01.0-1.2^8.16.4, 7.0> **Note:** Symfony 8.0 requires PHP 8.4+

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
```

### 4. Entity Implementation

[](#4-entity-implementation)

```