Symfony

https://symfony.com/doc/current/
Admin
Symfony is a robust PHP web framework designed for building high-performance web applications,...
Tokens:1,258,752
Snippets:12,012
Trust Score:9.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### mate/extensions.php configuration example

Source: https://symfony.com/doc/current/ai/components/mate.html

Example of the `mate/extensions.php` file. Only changes to the `enabled` and `mode` keys of a skill are kept; every other key is overwritten on the next install. Use `discover` or `skills:*` commands instead of manual editing.

```php
// mate/extensions.php
// This file is managed by Mate - use `discover` or `skills:*` commands
// over manual editing. Only changes to `mode` or `enabled` are kept,
// every other key is overwritten by Mate.

return [
    'vendor/package-name' => ['enabled' => true],
    'vendor/another-package' => ['enabled' => false],
];
```

--------------------------------

### Implement ManagedStoreInterface with setup and drop methods

Source: https://symfony.com/doc/current/ai/components/chat.html

Use this snippet to create a custom store that requires setup and teardown, implementing both ManagedStoreInterface and MessageStoreInterface. The setup() method accepts an optional options array for store creation, and drop() removes the store and related messages. The example shows the necessary imports and a class skeleton with placeholder implementations.

```php
use Symfony\AI\Chat\ManagedStoreInterface;
use Symfony\AI\Chat\MessageStoreInterface;

class MyCustomStore implements ManagedStoreInterface, MessageStoreInterface
{
    # ...

    public function setup(array $options = []): void
    {
        // Implementation to create the store
    }

    public function drop(): void
    {
        // Implementation to drop the store (and related messages)
    }
}
```

--------------------------------

### Enable and start systemd worker instances

Source: https://symfony.com/doc/current/messenger.html

Use systemctl --user to enable and start one or multiple worker instances. The example enables and starts instance 1, then shows how to enable and start 20 workers using brace expansion. This requires the service file to be named with the @ symbol.

```bash
$ systemctl --user enable messenger-worker@1.service
$ systemctl --user start messenger-worker@1.service

# to enable and start 20 workers
$ systemctl --user enable messenger-worker@{1..20}.service
$ systemctl --user start messenger-worker@{1..20}.service

```

--------------------------------

### Using Console Input

Source: https://symfony.com/doc/current/tui/integrations/symfony_console.html

Example of reading Console arguments and options before starting the Tui to configure widgets.

```APIDOC
## Using Console Input

### Description
Demonstrates how to use Console input arguments to set initial widget values before running the Tui.

### Method
N/A (PHP code example)

### Endpoint
N/A

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```php
protected function execute(
    InputInterface $input,
    OutputInterface $output,
): int {
    $name = $input->getArgument('name');

    $tui = new Tui();

    $keys = new Keybindings(['quit' => ['ctrl+c']]);
    $tui->addListener(
        static function (InputEvent $event) use ($tui, $keys): void {
            if ($keys->matches($event->getData(), 'quit')) {
                $tui->stop();
            }
        }
    );

    $editor = new EditorWidget();
    $editor->setText($name);

    // ...
}
```

### Response
#### Success Response (200)
- **output** (string) - The Tui runs with the editor pre-filled with the argument value.

#### Response Example
N/A
```

--------------------------------

### Retrieve alternative BrowserKit clients (Symfony kernel, HttpBrowser, Panther)

Source: https://symfony.com/doc/current/testing/end_to_end.html

Shows how to get existing clients via static methods and create custom ones. Note that when initializing a custom client, the integrated web server is not started automatically; use PantherTestCase::startWebServer() or WebServerManager to start it manually.

```php
namespace App\Tests;

use Symfony\Component\Panther\Client;
use Symfony\Component\Panther\PantherTestCase;

class AppTest extends PantherTestCase
{
    public function testMyApp(): void
    {
        // retrieve an existing client
        $symfonyClient = static::createClient();
        $httpBrowserClient = static::createHttpBrowserClient();
        $pantherClient = static::createPantherClient();
        $firefoxClient = static::createPantherClient(['browser' => static::FIREFOX]);

        // create a custom client
        $customChromeClient = Client::createChromeClient(null, null, [], 'https://example.com');
        $customFirefoxClient = Client::createFirefoxClient(null, null, [], 'https://example.com');
        $customSeleniumClient = Client::createSeleniumClient('http://127.0.0.1:4444/wd/hub', null, 'https://example.com');

        // if you are testing a Symfony app, you also have access to the kernel
        $kernel = static::createKernel();

        // ...
    }
}
```

--------------------------------

### ai:store:setup command usage

Source: https://symfony.com/doc/current/ai/bundles/ai-bundle.html

Prepares the required infrastructure for a store (e.g., creates database tables, indexes, collections). Only works with stores that implement ManagedStoreInterface.

```bash
$ php bin/console ai:store:setup <store>

# Setup the chromadb store
$ php bin/console ai:store:setup chromadb.default
```

--------------------------------

### Install AI Bundle and Agent component with Composer

Source: https://symfony.com/doc/current/ai/index.html

Run this command to install the AI Bundle and the Agent component, which are required to get started with Symfony AI.

```bash
$ composer require symfony/ai-bundle symfony/ai-agent
```

--------------------------------

### Create a directory with Filesystem and Path

Source: https://symfony.com/doc/current/components/filesystem.html

This example shows how to use the Filesystem and Path classes. It creates a directory in the system temp directory with a random suffix, and catches IOExceptionInterface to handle errors, printing the path where the error occurred.

```php
use Symfony\Component\Filesystem\Exception\IOExceptionInterface;
use Symfony\Component\Filesystem\Filesystem;
use Symfony\Component\Filesystem\Path;

$filesystem = new Filesystem();

try {
    $filesystem->mkdir(
        Path::normalize(sys_get_temp_dir().'/'.random_int(0, 1000)),
    );
} catch (IOExceptionInterface $exception) {
    echo "An error occurred while creating your directory at ".$exception->getPath();
}
```

--------------------------------

### Install the certificate authority for HTTPS

Source: https://symfony.com/doc/current/setup/symfony_cli.html

Install the certificate authority once with `symfony server:ca:install`, then start or restart the server to use HTTPS automatically.

```bash
# install the certificate authority (run this only once on your machine)
$ symfony server:ca:install

# now start (or restart) your server; it will use HTTPS automatically
$ symfony server:start
```

--------------------------------

### Install Symfony Workflow Component

Source: https://symfony.com/doc/current/the-fast-track/en/19-workflow.html

Use this command to install the Symfony Workflow Component via Composer. Run it in your project directory. After installation, you can start defining workflows in your configuration.

```bash
$ symfony composer req workflow
```

--------------------------------

### Get a configuration parameter with getParameter()

Source: https://symfony.com/doc/current/controller.html

Use $this->getParameter() to retrieve any configuration parameter from a controller. The example shows getting the kernel.project_dir parameter to build a path.

```PHP
// ...
public function index(): Response
{
    $contentsDir = $this->getParameter('kernel.project_dir').'/contents';
    // ...
}
```

--------------------------------

### Install HttpClient and Serializer

Source: https://symfony.com/doc/current/webhook.html

Run this command to install the required packages for sending webhooks.

```bash
$ composer require symfony/http-client symfony/serializer
```

--------------------------------

### Basic HttpKernel setup with EventDispatcher and resolvers

Source: https://symfony.com/doc/current/components/http_kernel.html

Shows the minimal setup for creating and running an HttpKernel instance. It creates a Request, dispatcher, controller and argument resolvers, then handles the request and terminates. The numbered lines above the code are line references, not part of the code.

```php
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\RequestStack;
use Symfony\Component\HttpKernel\Controller\ArgumentResolver;
use Symfony\Component\HttpKernel\Controller\ControllerResolver;
use Symfony\Component\HttpKernel\HttpKernel;

// create the Request object
$request = Request::createFromGlobals();

$dispatcher = new EventDispatcher();
// ... add some event listeners

// create your controller and argument resolvers
$controllerResolver = new ControllerResolver();
$argumentResolver = new ArgumentResolver();

// instantiate the kernel
$kernel = new HttpKernel($dispatcher, $controllerResolver, new RequestStack(), $argumentResolver);

// actually execute the kernel, which turns the request into a response
// by dispatching events, calling a controller, and returning the response
$response = $kernel->handle($request);

// send the headers and echo the content
$response->send();

// trigger the kernel.terminate event
$kernel->terminate($request, $response);
```

--------------------------------

### Get country code from timezone ID

Source: https://symfony.com/doc/current/components/intl.html

Uses Timezones::getCountryCode() to get the country code for a given timezone ID. The example shows 'America/Vancouver' returning 'CA' for Canada.

```php
$countryCode = Timezones::getCountryCode('America/Vancouver');
// => $countryCode = 'CA' (CA = Canada)
```

--------------------------------

### Verify Mate tools list with vendor/bin/mate tools:list

Source: https://symfony.com/doc/current/ai/components/mate/integration.html

Run this command to verify that Mate is working after initialization. The output is expected to be a list of available tools.

```bash
$ vendor/bin/mate tools:list
```

--------------------------------

### Get GMT offset in a specific locale

Source: https://symfony.com/doc/current/components/intl.html

Passes a locale as the third argument to getGmtOffset() to get the offset string in that locale. The example shows Arabic ('ar') and Dzongkha ('dz') translations.

```php
$offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'ar'); // $offset = 'غرينتش+01:00'
$offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'dz'); // $offset = 'ཇི་ཨེམ་ཏི་+01:00'
```

--------------------------------

### Get raw and GMT offsets for timezones

Source: https://symfony.com/doc/current/components/intl.html

Shows how to use Timezones::getRawOffset() and Timezones::getGmtOffset() to get the offset in seconds or as a GMT string. The example uses 'Etc/UTC', 'America/Buenos_Aires', and 'Asia/Katmandu'.

```php
$offset = Timezones::getRawOffset('Etc/UTC');              // $offset = 0
$offset = Timezones::getRawOffset('America/Buenos_Aires'); // $offset = -10800
$offset = Timezones::getRawOffset('Asia/Katmandu');        // $offset = 20700

$offset = Timezones::getGmtOffset('Etc/UTC');              // $offset = 'GMT+00:00'
$offset = Timezones::getGmtOffset('America/Buenos_Aires'); // $offset = 'GMT-03:00'
$offset = Timezones::getGmtOffset('Asia/Katmandu');        // $offset = 'GMT+05:45'
```

--------------------------------

### Console Commands: ai:store:setup and ai:store:index

Source: https://symfony.com/doc/current/ai/cookbook/ai-bundle-fast-track.html

Commands to prepare the store infrastructure and index documents from the console.

```APIDOC
## [CONSOLE] ai:store:setup

### Description
Sets up the store infrastructure for a given store configuration.

### Command
`php bin/console ai:store:setup chromadb.knowledge_base`

### Parameters
- `store` (string) - Required - The store configuration key (e.g., `chromadb.knowledge_base`).

### Response
No response body; command output indicates success.

## [CONSOLE] ai:store:index

### Description
Indexes documents from a source into the configured store using the indexer.

### Command
`php bin/console ai:store:index docs --source=/path/to/document.txt`

### Parameters
- `indexer` (string) - Required - The indexer configuration key (e.g., `docs`).
- `--source` (string) - Required - Path to the document to index.

### Response
No response body; command output indicates success.
```

--------------------------------

### Get Script Names with Scripts::getNames()

Source: https://symfony.com/doc/current/components/intl.html

Retrieve script names using the Scripts class. The example shows getting all names and a single name, with comments showing expected output.

```php
use Symfony\Component\Intl\Scripts;

\Locale::setDefault('en');

$scripts = Scripts::getNames();
// ('scriptCode' => 'scriptName')
// => ['Adlm' => 'Adlam', 'Afak' => 'Afaka', ...]

$script = Scripts::getName('Hans');
// => 'Simplified'
```

--------------------------------

### Start server and open browser in one command

Source: https://symfony.com/doc/current/setup/symfony_cli.html

Use `symfony server:start --open` to start the local server and open the URL in your browser in a single command.

```bash
$ symfony server:start --open
```

--------------------------------

### Create new client with withOptions()

Source: https://symfony.com/doc/current/http_client.html

Use withOptions() to create a new client instance with new default options. The options include base_uri, headers, and extra.

```php
$this->client = $client->withOptions([
    'base_uri' => 'https://...',
    'headers' => ['header-name' => 'header-value'],
    'extra' => ['my-key' => 'my-value'],
]);
```

--------------------------------

### Select image and get Image object

Source: https://symfony.com/doc/current/components/dom_crawler.html

Use `selectImage()` to find an image by its `alt` attribute, then call `image()` to get the `Image` object. The example shows selecting an image with alt text 'Kitten' and getting the image object directly in one line.

```php
$imagesCrawler = $crawler->selectImage('Kitten');
$image = $imagesCrawler->image();

// or do this all at once
$image = $crawler->selectImage('Kitten')->image();
```

--------------------------------

### Create and render a table with Table helper

Source: https://symfony.com/doc/current/console/helpers/table.html

Use the Table class to create a table, set headers and rows, and render it. The example shows a command that outputs a table with book data. The output is a formatted ASCII table with borders and padding.

```php
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Helper\Table;
use Symfony\Component\Console\Output\OutputInterface;
// ...

#[AsCommand(name: 'app:my-command')]
class MyCommand
{
    public function __invoke(OutputInterface $output): int
    {
        $table = new Table($output);
        $table
            ->setHeaders(['ISBN', 'Title', 'Author'])
            ->setRows([
                ['99921-58-10-7', 'Divine Comedy', 'Dante Alighieri'],
                ['9971-5-0210-0', 'A Tale of Two Cities', 'Charles Dickens'],
                ['960-425-059-0', 'The Lord of the Rings', 'J. R. R. Tolkien'],
                ['80-902734-1-6', 'And Then There Were None', 'Agatha Christie'],
            ])
        ;
        $table->render();

        return Command::SUCCESS;
    }
}
```

--------------------------------

### Example manifest.json output

Source: https://symfony.com/doc/current/frontend/encore/versioning.html

Example of the manifest.json file generated by Encore. It maps original asset paths to versioned filenames. This file is needed to get the versioned filename of other files like fonts or images.

```json
{
    "build/app.js": "/build/app.123abc.js",
    "build/dashboard.css": "/build/dashboard.a4bf2d.css",
    "build/images/logo.png": "/build/images/logo.3eed42.png"
}
```

--------------------------------

### Get timezones for a country code

Source: https://symfony.com/doc/current/components/intl.html

Uses Timezones::forCountryCode() to get an array of timezone IDs for a given country code (uppercase). The example shows Chile ('CL') returning three timezone IDs.

```php
// unlike language codes, country codes are always uppercase (CL = Chile)
$timezones = Timezones::forCountryCode('CL');
// => ['America/Punta_Arenas', 'America/Santiago', 'Pacific/Easter']
```

--------------------------------

### Enable multiple server tools simultaneously

Source: https://symfony.com/doc/current/ai/components/platform/gemini-server-tools.html

Shows how to enable multiple server tools at once: URL Context, Google Search, and Code Execution. The example asks to calculate the factorial of 20 and show the code. Uses 'server_tools' with all three options set to true.

```php
$messages = new MessageBag(
    Message::ofUser('Calculate the factorial of 20 and show me the code')
);

$result = $platform->invoke('gemini-2.5-pro', $messages, [
    'server_tools' => [
        'url_context' => true,
        'google_search' => true,
        'code_execution' => true,
    ]
]);
```

--------------------------------

### symfony server:start

Source: https://symfony.com/doc/current/the-fast-track/ja/3-zero.html

開発用に最適化されたWebサーバを起動します。バックグラウンドで実行するには -d フラグを使用します。

```APIDOC
## symfony server:start

### Description
開発用に最適化されたWebサーバを起動します。Symfony とうまく連携しますが、開発用としてのみ使用し、本番環境では使用しないでください。

### Method
CLI

### Command
`symfony server:start -d`

### Parameters
#### Options
- **-d** (boolean) - Optional - バックグラウンドでサーバを起動します。

### Description
サーバは 8000 番からはじまる使用可能なポートで立ち上がります。

### Example
```
$ symfony server:start -d
```

```

--------------------------------

### Show help for make:controller

Source: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html

Use the --help option to see optional arguments and options for a specific make command. This example shows the help for make:controller.

```bash
$ php bin/console make:controller --help
```

--------------------------------

### mate init

Source: https://symfony.com/doc/current/ai/components/mate.html

Initializes AI Mate configuration and creates the mate/ directory.

```APIDOC
## mate init

### Description
Initialize AI Mate configuration and create the `mate/` directory.

### Method
CLI

### Command
`mate init`

### Parameters
None

### Request Example
```
$ mate init
```

### Response
#### Success Response
Configuration initialized and `mate/` directory created.

```

--------------------------------

### Get timezone offsets with a timestamp for DST

Source: https://symfony.com/doc/current/components/intl.html

Demonstrates passing a timestamp as the second argument to getRawOffset() and getGmtOffset() to get the offset at a specific point in time, accounting for DST changes. The example uses Madrid in 2019.

```php
// In 2019, the DST period in Madrid (Spain) went from March 31 to October 27
$offset = Timezones::getRawOffset('Europe/Madrid', strtotime('March 31, 2019'));   // $offset = 3600
$offset = Timezones::getRawOffset('Europe/Madrid', strtotime('April 1, 2019'));    // $offset = 7200
$offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 27, 2019')); // $offset = 'GMT+02:00'
$offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019')); // $offset = 'GMT+01:00'
```

--------------------------------

### Select links and get Link object

Source: https://symfony.com/doc/current/components/dom_crawler.html

Use `filter()` to find links by id or class, and `selectLink()` to find links by content. Both return a `Crawler` instance; call `link()` to get the `Link` object. The example shows selecting by id, class, and content, then getting the link directly in one line.

```php
// first, select the link by id, class or content...
$linkCrawler = $crawler->filter('#sign-up');
$linkCrawler = $crawler->filter('.user-profile');
$linkCrawler = $crawler->selectLink('Log in');

// ...then, get the Link object:
$link = $linkCrawler->link();

// or do all this at once:
$link = $crawler->filter('#sign-up')->link();
$link = $crawler->filter('.user-profile')->link();
$link = $crawler->selectLink('Log in')->link();
```

--------------------------------

### Mailer class with options array

Source: https://symfony.com/doc/current/components/options_resolver.html

Initial Mailer class that stores options in an array, used as the starting point for the examples.

```php
class Mailer
{
    protected array $options;

    public function __construct(array $options = [])
    {
        $this->options = $options;
    }
}
```

--------------------------------

### Setup the vector store with configuration

Source: https://symfony.com/doc/current/ai/components/store/s3-vectors.html

Initialize the vector store with required and optional settings. The 'dimension' is required; 'distanceMetric', 'dataType', 'encryption', and 'tags' are optional.

```php
// Setup the vector bucket and index
$store->setup([
    'dimension' => 1536,
    'distanceMetric' => \AsyncAws\S3Vectors\Enum\DistanceMetric::COSINE, // Optional
    'dataType' => \AsyncAws\S3Vectors\Enum\DataType::FLOAT32, // Optional
    'encryption' => ['kmsKeyId' => 'your-kms-key-id'], // Optional
    'tags' => ['env' => 'production'], // Optional
]);
```

--------------------------------

### Start the local web server

Source: https://symfony.com/doc/current/setup/symfony_cli.html

Serve a Symfony project with `symfony server:start`. The server listens on http://127.0.0.1:8000 by default.

```bash
$ cd my-project/
$ symfony server:start

  [OK] Web server listening on http://127.0.0.1:8000
  ...
```

--------------------------------

### Instantiate Agent with Processors

Source: https://symfony.com/doc/current/ai/components/agent.html

Shows how to create an Agent instance, passing platform, model, and processor arrays. The processors are provided during instantiation.

```php
use Symfony\AI\Agent\Agent;

// Initialize Platform, LLM and processors

$agent = new Agent($platform, $model, $inputProcessors, $outputProcessors);
```

--------------------------------

### PhpStanExtractor usage with example class

Source: https://symfony.com/doc/current/components/property_info.html

Shows a Foo class with a constructor property and how to use PhpStanExtractor to get type and description information from annotations.

```php
// src/Domain/Foo.php
class Foo
{
    /**
     * @param string $bar
     */
    public function __construct(
        private string $bar,
    ) {
    }
}

// Extraction.php
use Symfony\Component\PropertyInfo\Extractor\PhpStanExtractor;
use App\Domain\Foo;

$phpStanExtractor = new PhpStanExtractor();

// Type information.
$phpStanExtractor->getTypeFromConstructor(Foo::class, 'bar');
// Description information.
$phpStanExtractor->getShortDescription($class, 'bar');
$phpStanExtractor->getLongDescription($class, 'bar');
```

--------------------------------

### YAML configuration examples showing parameter evaluation

Source: https://symfony.com/doc/current/configuration/using_parameters_in_dic.html

Three YAML configuration examples demonstrating how %kernel.debug% is evaluated. The first sets logging to true, the second uses the parameter which gets evaluated, and the third passes the string '%kernel.debug%' which is always considered true.

```YAML
my_bundle:
    logging: true
    # true, as expected

my_bundle:
    logging: '%kernel.debug%'
    # true/false (depends on 2nd argument of the Kernel class),
    # as expected, because %kernel.debug% inside configuration
    # gets evaluated before being passed to the extension

my_bundle: ~
# passes the string "%kernel.debug%".
# Which is always considered as true.
# The Configurator does not know anything about
# "%kernel.debug%" being a parameter.
```

--------------------------------

### psql über Docker Compose ausführen

Source: https://symfony.com/doc/current/the-fast-track/de/7-database.html

Führt psql im Datenbankcontainer aus, wenn die psql-Binärdatei nicht lokal installiert ist. Verwendet die Datenbank 'app' und den Benutzer 'app'.

```bash
$ docker compose exec database psql app app
```

--------------------------------

### Configure asset_mapper.paths with namespaces

Source: https://symfony.com/doc/current/frontend/asset_mapper.html

Assigns a namespace to a path, prefixing the logical path of files in that directory. For example, files in 'vendor/some/package/assets/' get prefixed with 'some-package'.

```yaml
framework:
    asset_mapper:
        paths:
            assets/: ''
            vendor/some/package/assets/: 'some-package'
```

--------------------------------

### Install a third-party extension with Composer

Source: https://symfony.com/doc/current/ai/components/mate.html

Installs a third-party extension package for Mate. Run this command in your project root.

```bash
$ composer require vendor/symfony-tools
```

--------------------------------

### Redis Transport DSN Examples

Source: https://symfony.com/doc/current/messenger.html

Various DSN configurations for the Redis transport, including standard, cluster, Unix socket, TLS, and Sentinel setups.

```dotenv
# .env
MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
# Full DSN Example
MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0
# Redis Cluster Example
MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
# Redis Cluster with automatic node discovery
MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages?cluster=true
# Unix Socket Example
MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
# TLS Example
MESSENGER_TRANSPORT_DSN=rediss://localhost:6379/messages
# Multiple Redis Sentinel Hosts Example
MESSENGER_TRANSPORT_DSN=redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&sentinel_master=db
# Redis Sentinel with separate master and sentinel credentials
MESSENGER_TRANSPORT_DSN=redis://master-pass@?host[redis1:26379]&host[redis2:26379]&sentinel_master=db&auth=sentinel-pass
# Redis Sentinel with ACL credentials for both master and sentinel
MESSENGER_TRANSPORT_DSN=redis://master-user:master-pass@?host[redis1:26379]&host[redis2:26379]&sentinel_master=db&auth[]=sentinel-user&auth[]=sentinel-pass
```

--------------------------------

### Install Qdrant store with Composer

Source: https://symfony.com/doc/current/ai/components/store/bridges.html

Install the Symfony AI Qdrant store package using Composer.

```bash
$ composer require symfony/ai-qdrant-store
```

--------------------------------

### Getting HTML of Crawler Nodes

Source: https://symfony.com/doc/current/components/dom_crawler.html

Shows how to retrieve the HTML content of a Crawler's nodes. The first example iterates over all nodes to concatenate their HTML. The second uses html() to get the first node's HTML, which throws an exception if the node does not exist unless a default value is provided. The third uses outerHtml() to get the outer HTML of the first node.

```php
$html = '';

foreach ($crawler as $domElement) {
    $html .= $domElement->ownerDocument->saveHTML($domElement);
}
```

```php
// if the node does not exist, calling to html() will result in an exception
$html = $crawler->html();

// avoid the exception passing an argument that html() returns when node does not exist
$html = $crawler->html('Default <strong>HTML</strong> content');
```

```php
$html = $crawler->outerHtml();
```

--------------------------------

### Get node name with Crawler::nodeName()

Source: https://symfony.com/doc/current/components/dom_crawler.html

Use this to get the HTML tag name (e.g., "p" or "div") of the first node in the current selection. The example uses filterXPath() to select the first child element under <body> and then calls nodeName().

```php
// returns the node name (HTML tag name) of the first child element under <body>
$tag = $crawler->filterXPath('//body/*')->nodeName();
```

--------------------------------

### Create Qdrant store with StoreFactory

Source: https://symfony.com/doc/current/ai/components/store/bridges.html

Create a Qdrant store instance using StoreFactory::create(). The collection is created by setup().

```php
use Symfony\AI\Store\Bridge\Qdrant\StoreFactory;

$store = StoreFactory::create(
    'my_documents',
    'http://localhost:6333',
    'your-api-key',
    embeddingsDimension: 1536,
    embeddingsDistance: 'Cosine',
);
```

--------------------------------

### Docker Compose starten

Source: https://symfony.com/doc/current/the-fast-track/de/7-database.html

Startet Docker Compose im Hintergrund und entfernt verwaiste Container. Warten Sie danach, bis die Datenbank hochgefahren ist.

```bash
$ docker compose up -d --remove-orphans
```

--------------------------------

### Get parameter in controller with getParameter() helper

Source: https://symfony.com/doc/current/configuration.html

In controllers extending AbstractController, use the getParameter() helper to access configuration parameters. This example retrieves 'kernel.project_dir' and 'app.admin_email'.

```php
// src/Controller/UserController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class UserController extends AbstractController
{
    // ...

    public function index(): Response
    {
        $projectDir = $this->getParameter('kernel.project_dir');
        $adminEmail = $this->getParameter('app.admin_email');

        // ...
    }
}
```

--------------------------------

### Standalone serializer setup with MetadataAwareNameConverter

Source: https://symfony.com/doc/current/serializer.html

Configures a standalone serializer with the MetadataAwareNameConverter to use the SerializedName attribute mapping. The example shows the necessary normalizers and serialization result.

```PHP
use App\Model\Person;
use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
use Symfony\Component\Serializer\NameConverter\MetadataAwareNameConverter;
use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
use Symfony\Component\Serializer\Serializer;

// ...

// Configure a loader to retrieve mapping information like SerializedName.
// E.g. when using PHP attributes:
$classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
$nameConverter = new MetadataAwareNameConverter($classMetadataFactory);
$normalizers = [
    new ObjectNormalizer($classMetadataFactory, $nameConverter),
];

$serializer = new Serializer($normalizers, $encoders);

$person = new Person('Jane Doe', 32, false);
$json = $serializer->serialize($person, 'json');
// $json contains {"customer_name":"Jane Doe", ...}

```

--------------------------------

### YAML connection string shorthand

Source: https://symfony.com/doc/current/components/config/definition.html

Example of YAML config with 'connection' as a string.

```yaml
connection: my_mysql_connection

```

--------------------------------

### Install Supervisor on Ubuntu

Source: https://symfony.com/doc/current/messenger.html

Command to install Supervisor using apt-get on Ubuntu.

```bash
$ sudo apt-get install supervisor
```

--------------------------------

### Asynchronous request example

Source: https://symfony.com/doc/current/http_client.html

Demonstrates the asynchronous nature of the HTTP client. The request starts immediately but execution continues until getHeaders() or getContent() is called, which block until the response is available.

```php
// the request starts, but execution continues without waiting
$response = $client->request('GET', 'http://releases.ubuntu.com/18.04.2/ubuntu-18.04.2-desktop-amd64.iso');

// this blocks until the response headers are received
$contentType = $response->getHeaders()['content-type'][0];

// this blocks until the full response body is received
$content = $response->getContent();
```

--------------------------------

### Full HttpKernel working example

Source: https://symfony.com/doc/current/components/http_kernel.html

This example sets up a route collection with a single 'hello' route, creates a request from globals, and uses the HttpKernel with a RouterListener, ControllerResolver, and ArgumentResolver to handle and send the response. It also calls terminate() after sending.

```php
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\RequestStack;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Controller\ArgumentResolver;
use Symfony\Component\HttpKernel\Controller\ControllerResolver;
use Symfony\Component\HttpKernel\EventListener\RouterListener;
use Symfony\Component\HttpKernel\HttpKernel;
use Symfony\Component\Routing\Matcher\UrlMatcher;
use Symfony\Component\Routing\RequestContext;
use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;

$routes = new RouteCollection();
$routes->add('hello', new Route('/hello/{name}', [
    '_controller' => function (Request $request): Response {
        return new Response(
            sprintf("Hello %s", $request->attributes->get('name'))
        );
    }]
));

$request = Request::createFromGlobals();

$matcher = new UrlMatcher($routes, new RequestContext());

$dispatcher = new EventDispatcher();
$dispatcher->addSubscriber(new RouterListener($matcher, new RequestStack()));

$controllerResolver = new ControllerResolver();
$argumentResolver = new ArgumentResolver();

$kernel = new HttpKernel($dispatcher, $controllerResolver, new RequestStack(), $argumentResolver);

$response = $kernel->handle($request);
$response->send();

$kernel->terminate($request, $response);
```

--------------------------------

### Inject and use an MCP client with #[Target]

Source: https://symfony.com/doc/current/ai/bundles/mcp-bundle.html

Autowire the McpClientInterface by parameter name or with #[Target]. The example shows a ResearchService that gets a connection, lists tools, and calls a tool.

```php
use Symfony\AI\McpBundle\Client\McpClientInterface;
use Symfony\Component\DependencyInjection\Attribute\Target;

class ResearchService
{
    public function __construct(
        #[Target('research')] private McpClientInterface $client,
    ) {
    }

    public function run(string $path): string
    {
        $connection = $this->client->get('filesystem');

        foreach ($connection->getTools() as $tool) {
            // $tool is an Mcp\Schema\Tool
        }

        $result = $connection->callTool('read_file', ['path' => $path]);

        return $result->content[0]->text;
    }
}
```

--------------------------------

### mate/config.php services configuration example

Source: https://symfony.com/doc/current/ai/components/mate.html

Example of the `mate/config.php` file. Use the `ContainerConfigurator` to override default parameters and register custom services. Commented lines show how to set `mate.cache_dir` and `mate.env_file`.

```php
// mate/config.php
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $container): void {
    $container->parameters()
        // Override default parameters here
        // ->set('mate.cache_dir', sys_get_temp_dir().'/mate')
        // ->set('mate.env_file', '.env') // Loads the project's own .env and .env.local
    ;

    $container->services()
        // Register your custom services here
    ;
};
```

--------------------------------

### Example configuration result in XML

Source: https://symfony.com/doc/current/components/config/definition.html

This is the XML configuration that results from the appended parameters node example. It shows the <database> root element with a <connection> element containing driver, host, username, password, memory attributes and a <parameters> prototype with name and value attributes.

```xml
<database>
    <!-- driver: Required -->
    <connection
        driver=""
        host="localhost"
        username=""
        password=""
        memory="false"
    >

        <!-- prototype -->
        <!-- value: Required -->
        <parameters
            name="parameters name"
            value=""
        />

    </connection>
</database>
```

--------------------------------

### Override action and method in Twig template

Source: https://symfony.com/doc/current/forms.html

Pass 'action' and 'method' to form_start() in Twig to override the form's action and method. The example uses path('target_route') and 'GET'.

```twig
{# templates/task/new.html.twig #}
{{ form_start(form, {'action': path('target_route'), 'method': 'GET'}) }}
```

--------------------------------

### Pass Locale to Language Methods

Source: https://symfony.com/doc/current/components/intl.html

All methods accept an optional locale parameter that defaults to the current default locale. This example shows passing 'de' to get German translations.

```php
$languages = Languages::getNames('de');
// => ['ab' => 'Abchasisch', 'ace' => 'Aceh', ...]

$languages = Languages::getAlpha3Names('de');
// => ['abk' => 'Abchasisch', 'ace' => 'Aceh', ...]

$language = Languages::getName('fr', 'de');
// => 'Französisch'

$language = Languages::getAlpha3Name('fra', 'de');
// => 'Französisch'
```

--------------------------------

### Get Route Name and Parameters in Controller

Source: https://symfony.com/doc/current/routing.html

Use this snippet in a Symfony controller to retrieve the current route name and parameters via the Request object's attributes. The route name is accessed with '_route' and parameters with '_route_params'. The example also shows how to get all attributes. This is useful for dynamic behavior based on the current route.

```php
// src/Controller/BlogController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class BlogController extends AbstractController
{
    #[Route('/blog', name: 'blog_list')]
    public function list(Request $request): Response
    {
        $routeName = $request->attributes->get('_route');
        $routeParameters = $request->attributes->get('_route_params');

        // use this to get all the available attributes (not only routing ones):
        $allAttributes = $request->attributes->all();

        // ...
    }
}
```

--------------------------------

### Confirm skills are installed with mate skills:list

Source: https://symfony.com/doc/current/ai/components/mate/integration.html

Run `vendor/bin/mate skills:list` to confirm the skills are installed. A skill in state `disabled` is not installed; an empty list means no enabled extension ships skills.

```bash
$ vendor/bin/mate skills:list
```

--------------------------------

### Dynamic namespace examples

Source: https://symfony.com/doc/current/components/cache.html

Shows multiple ways to create dynamic namespaces based on locale, feature toggle, and route. Each example uses withSubNamespace() with different parameters.

```php
$localeCache = $cache->withSubNamespace($request->getLocale());

$flagCache = $cache->withSubNamespace(
    $featureToggle->isEnabled('new_checkout') ? 'checkout-v2' : 'checkout-v1'
);

$channel = $request->attributes->get('_route')?->startsWith('api_') ? 'api' : 'web';
$channelCache = $cache->withSubNamespace($channel);
```

--------------------------------

### Get Locale Names with Locale Parameter

Source: https://symfony.com/doc/current/components/intl.html

Retrieves locale names using a specific locale passed as the last parameter. The example uses 'de' and shows the expected output format.

```php
$locales = Locales::getNames('de');
// => ['af' => 'Afrikaans', 'af_NA' => 'Afrikaans (Namibia)', ...]

$locale = Locales::getName('zh_Hans_MO', 'de');
// => 'Chinesisch (Vereinfacht, Sonderverwaltungsregion Macau)'
```

--------------------------------

### Get Country Names with Locale Parameter

Source: https://symfony.com/doc/current/components/intl.html

Retrieves country names using a specific locale passed as the last parameter. The example uses 'de' and shows the expected output format.

```php
$countries = Countries::getNames('de');
// => ['AF' => 'Afghanistan', 'EG' => 'Ägypten', ...]

$countries = Countries::getAlpha3Names('de');
// => ['AFG' => 'Afghanistan', 'EGY' => 'Ägypten', ...]

$country = Countries::getName('GB', 'de');
// => 'Vereinigtes Königreich'

$country = Countries::getAlpha3Name('GBR', 'de');
// => 'Vereinigtes Königreich'
```

--------------------------------

### Install Mate Skills

Source: https://symfony.com/doc/current/ai/components/mate.html

Installs the skills by writing SKILL.md files of every enabled extension into .agents/skills/ and .claude/skills/. This step is required for agents to know when to use which tool.

```bash
$ vendor/bin/mate skills:install
```
Tokens:
Raw