Выход Symfony 7.4 является ключевым моментом для разработчиков PHP, особенно тех из нас, которые разрабатывают высокопроизводительные облачные приложения.В то время как changelog наполнен обычным набором улучшений опыта разработчиков (DX) и улучшений производительности, одна особенность выделяется как игровой преобразователь для инфраструктурных команд и задних конечностей: . Share Directory В течение многих лет мы боролись с «дилеммой кеша» в средах с несколькими серверами.Мы писали хакерские скрипты, управляли сложными настройками NFS и принимали штрафы за производительность — все это для того, чтобы сохранить состояние нашего приложения синхронизированным. В этой статье мы рассмотрим новые Узнать важнейшую проблему, которую он решает, и реализовать надежную, готовую к производству конфигурацию с помощью Symfony 7.4, Doctrine и Flysystem. var/share «Дилемма кэша»: история барьеров в производительности Чтобы оценить элегантность Share Directory, мы должны сначала пересмотреть боль прошлого. Исторически каталог был демпингом для двух очень разных типов данных: var/cache 
 
 
 Системный кэш: Это включает в себя компилированный сервисный контейнер, маршруты, соответствующие URL-адресам, оптимизированные шаблоны Twig и карты классов. Эти данные неизменны (или должны быть) после фазы кэша:warmup. Приложение Кэш: Это включает в себя вашу базу кэш.приложений, ответы API, серийные объекты и потенциально временное хранилище файлов.Эти данные являются волатильными и общими.Если сервер А кеширует большой запрос базы данных, сервер B должен быть в состоянии его прочитать. Проблема в кластере Представьте, что вы развертываете приложение Symfony в кластер Kubernetes с 10 подгруппами. 
 
 
 Сценарий A (Локальный кэш):Вы держите var/cache локально для каждого pod.Результат: Системный кэш быстрый (локальный SSD). Тем не менее, кэш приложений фрагментирован. Если пользователь попадает на Pod 1, их данные там кешируются. Если их следующее запрос попадает на Pod 2, кэш пропадает и база данных снова попадает. Сценарий B (Shared Storage):Вы монтируете var/cache на общий объем (NFS, EFS).Результат: Кэш приложения является последовательным во всех поддонах. Великолепный! Но теперь, каждый раз, когда Symfony нуждается в загрузке класса или проверке маршрута (System Cache), он должен пересекать сеть, чтобы прочитать из общего хранилища. Мы застряли, выбирая между и . consistency performance Введите каталог Share (var/share) Symfony 7.4 вводит специальную архитектурную концепцию для решения этой проблемы: . Share Directory Эта функция формально отсоединяет местоположение системно-специфических файлов от файлов, используемых приложением. 
 
 
 var/cache: остается домом для System Cache. Он должен оставаться локальным к серверу (эфимерное хранилище в терминах K8). var/share: Новый дом для прикладных данных. Этот каталог предназначен для установки на совместное хранилище (например, NFS, AWS EFS или постоянный объем). Это разделение позволяет нам иметь лучшее из обоих миров: быстрые, локальные системные кэши и последовательное, совместное состояние приложений. Руководство по внедрению Мы построим приложение Symfony 7.4, которое использует Share Directory для трех распространенных случаев использования: 
 
 
 
 Общий кэш приложений Общее хранилище файлов (Uploads) Общая база данных SQLite (для простого состояния) Предпосылки и установка Убедитесь, что вы используете PHP 8.2 или выше и установили CLI Symfony. symfony new my_app --webapp
cd my_app
composer require symfony/framework-bundle:^7.4
 Основная конфигурация В новой установке Symfony 7.4 рамка уже знает об этой концепции. Вы увидите новую переменную среды: .env # .env
APP_SHARE_DIR=$APP_PROJECT_DIR/var/share
 Под капотом, на Класс теперь реализует a Если вы обновляете существующее приложение, вам может потребоваться добавить его вручную или полагаться на стандартную версию (которая указывает на каталог кэша для обратной совместимости). Kernel getShareDir() Чтобы применить эту структуру в обновленном приложении, обновите при необходимости, или просто определить переменную окружающей среды. Kernel.php Конфигурирование совместных кэш-полов Самая немедленная победа - перемещение кэша приложения в общий каталог. по умолчанию адаптер кэша файловой системы Symfony сохраняет Мы хотим перенести это на . var/cache/pools var/share/pools Открытый Мы настроим стандартный кэш приложений для использования нового По параметрам . config/packages/cache.yaml %kernel.share_dir% # config/packages/cache.yaml
framework:
    cache:
        # distinct_id helps avoid collisions if multiple apps share the same storage
        prefix_seed: 'my_app_%env(APP_ENV)%'

        # Default app cache
        app: cache.adapter.filesystem

        # System cache (stays in var/cache, FAST!)
        system: cache.adapter.system 

        # Configure filesystem adapter to use the share directory
        default_redis_provider: 'redis://localhost'
        
        pools:
            # We explicitly tell the 'cache.app' pool to use the share directory
            cache.app:
                adapter: cache.adapter.filesystem
                provider: ~
                # The 'directory' option is available for the filesystem adapter
                # We use the new container parameter
                default_lifetime: 3600
                provider: 'cache.default_marshaller' 
                
services:
    # We need to configure the specific directory for the filesystem adapter
    # Since we can't easily pass the directory in the simplified YAML above for the main adapter,
    # we can define a custom adapter or rely on the global default if Symfony 7.4 automates it.
    
    # However, for explicit control, let's define a shared pool:
    cache.adapter.shared_filesystem:
        parent: 'cache.adapter.filesystem'
        tags: ['cache.pool']
        arguments:
            $directory: '%kernel.share_dir%/pools'

framework:
    cache:
        app: cache.adapter.shared_filesystem
 В стандартной версии Symfony 7.4 адаптер файловой системы по умолчанию все равно может При этом явно создавая услугу указать на Мы гарантируем, что наш кэш-приложение хранится в нужном месте. cache_dir cache.adapter.shared_filesystem %kernel.share_dir%/pools Чтобы проверить это, очистите свой кэш и подогрейте его. php bin/console cache:clear
php bin/console cache:pool:clear cache.app
 Затем генерируйте некоторые записи кэша (например, посещая страницу). Проверьте структуру каталога: ls -la var/share/pools
 Вы должны видеть структуру папок, созданную адаптером кэша. Совместное хранение файлов с Flysystem Обработка загрузок пользователей в кластере является классическим случаем использования для совместного хранения. Для того чтобы настроить адаптер для хранения . league/flysystem-bundle var/share/storage Installation: composer require league/flysystem-bundle
 Открытый . Configuration: config/packages/flysystem.yaml # config/packages/flysystem.yaml
flysystem:
    storages:
        default.storage:
            adapter: 'local'
            options:
                # Use the new kernel parameter
                directory: '%kernel.share_dir%/storage'
 Теперь давайте создадим сервис для обработки загрузок файлов с помощью этого хранилища. Инъекции от зависимости. PHP 8 Attributes namespace App\Service;

use League\Flysystem\FilesystemOperator;
use Symfony\Component\DependencyInjection\Attribute\Target;
use Symfony\Component\HttpFoundation\File\UploadedFile;

class FileManager
{
    public function __construct(
        #[Target('default.storage')]
        private readonly FilesystemOperator $storage
    ) {}

    public function uploadUserFile(UploadedFile $file, string $userId): string
    {
        $filename = sprintf('%s/%s.%s', $userId, uniqid(), $file->guessExtension());

        $stream = fopen($file->getPathname(), 'r');
        
        // Write to var/share/storage/...
        $this->storage->writeStream($filename, $stream);

        if (is_resource($stream)) {
            fclose($stream);
        }

        return $filename;
    }
    
    public function getFileContent(string $filename): string
    {
        return $this->storage->read($filename);
    }
}
 Когда вы развернете это в Kubernetes, вы монтируете Постоянное требование объема (ПВХ) на Если Pod A загружает файл, он записывается в ПВХ. Pod B может немедленно прочитать этот файл по тому же пути, потому что они разделяют основной объем хранения. /app/var/share Общая база данных SQLite (The “Lite” Cluster) Хотя обычно не рекомендуется для тяжелых сопутствующих писем, используя SQLite в это фантастический шаблон для данных с большим числом, низким уровнем записи или простых внутренних панелей инструментов, которые должны сохраняться во всех развертываниях без полной настройки MySQL/PostgreSQL. var/share Открытый . Configuration: config/packages/doctrine.yaml doctrine:
    dbal:
        # Use the standard SQLite driver
        driver: 'pdo_sqlite'
        # Point the path to the share directory
        path: '%kernel.share_dir%/db/app.sqlite'
        charset: UTF8
 Убедитесь, что каталог существует: mkdir -p var/share/db
 Теперь, когда вы управляете миграцией: php bin/console doctrine:migrations:migrate
 ТЭ Все серверы в вашем кластере будут читать из этого единого файла. .sqlite Убедитесь, что ваше решение совместного хранения поддерживает правильное блокирование файлов (например, AWS EFS с соответствующими опциями монтажа), или выделите это для сценариев с очень низкой частотой записи. Warning: DevOps: стратегия развертывания Чтобы в полной мере использовать эту функцию, ваше развертывание проявляется (например, или кубинские ) должны быть обновлены. docker-compose.yml deployment.yaml Docker Compose Пример Вот как имитировать производственную среду на местном уровне. services:
  app_1:
    build: .
    environment:
      APP_SHARE_DIR: /app/var/share
    volumes:
      - shared_data:/app/var/share

  app_2:
    build: .
    environment:
      APP_SHARE_DIR: /app/var/share
    volumes:
      - shared_data:/app/var/share

volumes:
  shared_data:
 В этой установке: 
 
 
 Системный кэш (var/cache) находится внутри контейнера (быстрый, изолированный). Объединенные данные (var/share) — это обозначенный объем, распределенный между app_1 и app_2. Стратегия Kubernetes (K8s) В Kubernetes вы бы использовали PersistentVolumeClaim. apiVersion: apps/v1
kind: Deployment
metadata:
  name: symfony-app
spec:
  replicas: 3
  template:
    spec:
      containers:
        - name: php
          image: my-symfony-app:7.4
          env:
            - name: APP_SHARE_DIR
              value: "/var/www/html/var/share"
          volumeMounts:
            - mountPath: "/var/www/html/var/share"
              name: shared-storage
      volumes:
        - name: shared-storage
          persistentVolumeClaim:
            claimName: efs-pvc
 Verification: 
 
 
 
 
 
 Exec into Pod 1: kubectl exec -it symfony-app-pod-1 — bash Создание файла: touch var/share/test.txt Exec into Pod 2: kubectl exec -it symfony-app-pod-2 — bash Проверьте файл: ls var/share/ Вы должны увидеть Test.txt. Руководство по миграции: обновление до 7.4 Если вы поддерживаете унаследованное приложение, принятие Share Directory требует нескольких тщательных шагов. 
 
 
 
 
 Обновление композитора: Обновление композитора composer.json для разрешения симфонии/*: 7.4. * Запустить обновление композитора «симфонии/*». Обновление .env: Добавьте APP_SHARE_DIR в свой .env и .env.test. Обновление .gitignore: Вы, как правило, не хотите комментировать содержимое каталога обмена, но вы можете сохранить gitkeep. Refactor Paths: Поиск вашей кодовой базы для hardcoded ссылок на kernel.cache_dir или var/cache. Если код использовал кэш каталог для хранения данных, которые должны быть сохранены или совместно (например, генерируемые отчеты PDF, временный экспорт), изменить его, чтобы использовать %kernel.share_dir%. Заключение Симфония 7.4 Это больше, чем просто новая структура папок; это сигнал о зрелости. Это признает, что современные приложения PHP живут в облаке, через кластеры и должны масштабироваться горизонтально, не сражаясь с рамкой. Share Directory При принятии Вы упрощаете конфигурацию инфраструктуры, улучшаете производительность системных кэшей и предоставляете четкое, стандартизированное местоположение для состояния вашего приложения. var/share Начните с обновления некритической микросервиса до Symfony 7.4 уже сегодня. Удалите эти сложные NFS-монты для вашей системной кэши и наблюдайте за тем, как среднее время отклика падает. Ready to scale? var/share Помогла ли эта статья вам уточнить путь обновления?Следуйте мне на [LinkedIn: Давайте вместе построим лучшее программное обеспечение. Keep in touch! https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Read My Stories

Этот звук создан на языке оригинала истории!

Share Directory Symfony 7.4 решает проблему с кеш-памятью для приложений Kubernetes

About Author

КОММЕНТАРИИ

БИРКИ

ЭТА СТАТЬЯ БЫЛА ПРЕДСТАВЛЕНА В

Related Stories

Хотите выиграть конкурс HackerNoon? Вот что рекомендуют победители конкурса #crypto-api

От форумов до лент новостей: как алгоритмы социальных сетей формируют цифровое взаимодействие

Краткое введение в теорию мозга Больцмана

Повысьте свою производительность с помощью этих 18 инструментов разработчика 🚀🔥

Хотите выиграть конкурс HackerNoon? Вот что рекомендуют победители конкурса #crypto-api

От форумов до лент новостей: как алгоритмы социальных сетей формируют цифровое взаимодействие

Краткое введение в теорию мозга Больцмана

Повысьте свою производительность с помощью этих 18 инструментов разработчика 🚀🔥

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps