Laravel Octane

업데이트됨

번역일: 2026년 8월 18일

이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.

원문 수정: 2026년 8월 18일
번역 갱신: 2026년 8월 18일

Laravel Octane

소개
설치
서버 사전 요구사항
애플리케이션 서비스 실행
의존성 주입과 Octane
메모리 누수 관리
동시 작업
틱과 인터벌
Octane 캐시
- 캐시 인터벌
테이블

소개

Laravel Octane은 FrankenPHP, Open Swoole, Swoole, RoadRunner 같은 고성능 애플리케이션 서버를 활용해 Laravel 애플리케이션의 성능을 크게 향상시켜 줍니다. Octane은 애플리케이션을 한 번만 부팅한 뒤 메모리에 유지하면서 요청을 매우 빠르게 처리합니다.

일반적인 PHP-FPM 방식은 요청마다 PHP 프로세스를 새로 초기화하지만, Octane은 애플리케이션을 메모리에 상주시켜 이 오버헤드를 제거합니다. 그 덕분에 처리 속도가 크게 향상되지만, 동시에 메모리 상태 관리에 주의가 필요합니다.

설치

Composer로 Octane을 설치합니다:

composer require laravel/octane

설치 후 octane:install Artisan 명령어를 실행하면 Octane 설정 파일이 애플리케이션에 추가됩니다:

php artisan octane:install

서버 사전 요구사항

FrankenPHP

FrankenPHP는 Go로 작성된 PHP 애플리케이션 서버로, Early Hints, Brotli 압축, Zstandard 압축 같은 최신 웹 기능을 지원합니다. Octane 설치 시 FrankenPHP를 서버로 선택하면, Octane이 자동으로 FrankenPHP 바이너리를 내려받아 설치합니다.

Laravel Sail에서 FrankenPHP 사용

Laravel Sail로 개발하는 경우 다음 명령어로 Octane과 FrankenPHP를 설치합니다:

./vendor/bin/sail up./vendor/bin/sail composer require laravel/octane

다음으로 octane:install 명령어로 FrankenPHP 바이너리를 설치합니다:

./vendor/bin/sail artisan octane:install --server=frankenphp

그런 다음, docker-compose.yml 파일의 laravel.test 서비스 정의에 SUPERVISOR_PHP_COMMAND 환경 변수를 추가합니다. 이 변수에 지정한 명령어로 Sail이 기존 PHP 개발 서버 대신 Octane을 사용해 애플리케이션을 실행합니다:

services:

  laravel.test:

    environment:

      SUPERVISOR_PHP_COMMAND: "/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan octane:start --server=frankenphp --host=0.0.0.0 --admin-port=2019 --port='${APP_PORT:-80}'" #

      XDG_CONFIG_HOME:  /var/www/html/config #

      XDG_DATA_HOME:  /var/www/html/data #

HTTPS, HTTP/2, HTTP/3를 활성화하려면 다음과 같이 설정합니다:

services:

  laravel.test:

    ports:

        - '${APP_PORT:-80}:80'

        - '${VITE_PORT:-5173}:${VITE_PORT:-5173}'

        - '443:443' #

        - '443:443/udp' #

    environment:

      SUPERVISOR_PHP_COMMAND: "/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan octane:start --host=localhost --port=443 --admin-port=2019 --https" #

      XDG_CONFIG_HOME:  /var/www/html/config #

      XDG_DATA_HOME:  /var/www/html/data #

FrankenPHP Sail 애플리케이션에는 https://localhost로 접근하는 것이 좋습니다. https://127.0.0.1은 추가 설정이 필요하며 권장되지 않습니다.

Docker에서 FrankenPHP 사용

FrankenPHP 공식 Docker 이미지를 사용하면 성능 향상과 정적 설치에 포함되지 않는 추가 PHP 익스텐션을 활용할 수 있습니다. 또한 Windows처럼 FrankenPHP가 기본적으로 지원하지 않는 플랫폼에서도 실행할 수 있으며, 로컬 개발 환경과 프로덕션 환경 모두에 적합합니다.

다음 Dockerfile을 시작점으로 사용할 수 있습니다:

FROM dunglas/frankenphp

RUN install-php-extensions \
    pcntl
    # 필요한 PHP 익스텐션을 추가하세요...

COPY . /app

ENTRYPOINT ["php", "artisan", "octane:frankenphp"]

개발 시에는 다음 Docker Compose 파일을 활용합니다:

# compose.yaml
services:
  frankenphp:
    build:
      context: .
    entrypoint: php artisan octane:frankenphp --workers=1 --max-requests=1
    ports:
      - "8000:8000"
    volumes:
      - .:/app

php artisan octane:start 명령어에 --log-level 옵션을 명시적으로 전달하면 Octane이 FrankenPHP의 네이티브 로거를 사용하며, 별도 설정이 없으면 구조화된 JSON 형식의 로그를 출력합니다.

Docker에서 FrankenPHP를 실행하는 방법에 대한 자세한 내용은 FrankenPHP 공식 문서를 참고하세요.

커스텀 Caddyfile 설정

FrankenPHP를 사용할 때 --caddyfile 옵션으로 커스텀 Caddyfile을 지정할 수 있습니다:

php artisan octane:start --server=frankenphp --caddyfile=/path/to/your/Caddyfile

이를 통해 커스텀 미들웨어 추가, 고급 라우팅 설정, 사용자 지정 디렉티브 설정 등 기본값 이상의 FrankenPHP 구성을 적용할 수 있습니다. Caddyfile 문법과 설정 옵션에 대한 자세한 내용은 Caddy 공식 문서를 참고하세요.

RoadRunner

RoadRunner는 Go로 작성된 RoadRunner 바이너리를 기반으로 합니다. RoadRunner 기반 Octane 서버를 처음 시작하면 Octane이 RoadRunner 바이너리를 자동으로 내려받아 설치할지 안내합니다.

Laravel Sail에서 RoadRunner 사용

Laravel Sail로 개발하는 경우 다음 명령어로 Octane과 RoadRunner를 설치합니다:

./vendor/bin/sail up./vendor/bin/sail composer require laravel/octane spiral/roadrunner-cli spiral/roadrunner-http

다음으로 Sail 쉘을 열고 rr 실행 파일로 최신 Linux용 RoadRunner 바이너리를 내려받습니다:

./vendor/bin/sail shell# Sail 쉘 내부에서..../vendor/bin/rr get-binary

그런 다음, docker-compose.yml 파일의 laravel.test 서비스 정의에 SUPERVISOR_PHP_COMMAND 환경 변수를 추가합니다:

services:

  laravel.test:

    environment:

      SUPERVISOR_PHP_COMMAND: "/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan octane:start --server=roadrunner --host=0.0.0.0 --rpc-port=6001 --port='${APP_PORT:-80}'" #

마지막으로 rr 바이너리에 실행 권한을 부여하고 Sail 이미지를 빌드합니다:

chmod +x ./rr./vendor/bin/sail build --no-cache

Swoole

Swoole 애플리케이션 서버를 사용하려면 Swoole PHP 익스텐션을 설치해야 합니다. 보통 PECL을 통해 설치합니다:

pecl install swoole

Open Swoole

Open Swoole을 사용하려면 Open Swoole PHP 익스텐션을 설치합니다:

pecl install openswoole

Open Swoole을 사용하면 동시 작업, 틱, 인터벌 등 Swoole과 동일한 기능을 사용할 수 있습니다.

Laravel Sail에서 Swoole 사용

WARNING

Sail로 Octane 애플리케이션을 서비스하기 전에 최신 버전의 Laravel Sail을 사용하고 있는지 확인하고, 애플리케이션 루트 디렉터리에서 ./vendor/bin/sail build --no-cache를 실행하세요.

Laravel Sail로도 Swoole 기반 Octane 애플리케이션을 개발할 수 있습니다. Laravel Sail에는 기본적으로 Swoole 익스텐션이 포함되어 있습니다. 다만, docker-compose.yml 파일 수정은 필요합니다.

docker-compose.yml 파일의 laravel.test 서비스 정의에 SUPERVISOR_PHP_COMMAND 환경 변수를 추가합니다:

services:

  laravel.test:

    environment:

      SUPERVISOR_PHP_COMMAND: "/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan octane:start --server=swoole --host=0.0.0.0 --port='${APP_PORT:-80}'" #

마지막으로 Sail 이미지를 빌드합니다:

./vendor/bin/sail build --no-cache

Swoole 설정

Swoole은 필요에 따라 octane 설정 파일에 추가할 수 있는 몇 가지 옵션을 제공합니다. 수정이 필요한 경우가 드물기 때문에 기본 설정 파일에는 포함되어 있지 않습니다:

'swoole' => [
    'options' => [
        'log_file' => storage_path('logs/swoole_http.log'),
        'package_max_length' => 10 * 1024 * 1024,
    ],
],

애플리케이션 서비스 실행

octane:start Artisan 명령어로 Octane 서버를 시작합니다. 기본적으로 octane 설정 파일의 server 옵션에 지정된 서버를 사용합니다:

php artisan octane:start

기본적으로 Octane은 포트 8000에서 시작되므로 브라우저에서 http://localhost:8000으로 접근할 수 있습니다.

프로덕션에서 Octane 상시 실행

프로덕션 환경에서는 Supervisor 같은 프로세스 모니터를 사용해 Octane 서버가 항상 실행 상태를 유지하도록 해야 합니다. 아래는 Octane을 위한 Supervisor 설정 예시입니다:

[program:octane]
process_name=%(program_name)s_%(process_num)02d
command=php /home/forge/example.com/artisan octane:start --server=frankenphp --host=127.0.0.1 --port=8000
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/forge/example.com/storage/logs/octane.log
stopwaitsecs=3600

HTTPS로 서비스 실행

기본적으로 Octane을 통해 실행되는 애플리케이션은 http://로 시작하는 링크를 생성합니다. HTTPS로 서비스할 때는 config/octane.php의 OCTANE_HTTPS 환경 변수를 true로 설정하면 됩니다. 이 값이 true이면 Octane이 Laravel에게 모든 생성 링크를 https://로 시작하도록 지시합니다:

'https' => env('OCTANE_HTTPS', false),

Nginx를 통한 서비스 실행

NOTE

서버 설정을 직접 관리할 준비가 되지 않았거나 Laravel Octane 애플리케이션 운영에 필요한 다양한 서비스 구성이 부담스럽다면, 완전 관리형 Laravel Octane 지원을 제공하는 Laravel Cloud를 검토해 보세요.

프로덕션 환경에서는 Octane 애플리케이션을 Nginx나 Apache 같은 웹 서버 뒤에서 실행하는 것이 좋습니다. 이렇게 하면 웹 서버가 이미지, CSS 같은 정적 파일을 직접 서비스하고 SSL 인증서 처리도 담당할 수 있습니다.

아래 Nginx 설정 예시에서 Nginx는 정적 파일을 직접 서비스하고, 나머지 요청은 포트 8000에서 실행 중인 Octane 서버로 프록시합니다:

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 80;
    listen [::]:80;
    server_name domain.com;
    server_tokens off;
    root /home/forge/domain.com/public;

    index index.php;

    charset utf-8;

    location /index.php {
        try_files /not_exists @octane;
    }

    location / {
        try_files $uri $uri/ @octane;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    access_log off;
    error_log  /var/log/nginx/domain.com-error.log error;

    error_page 404 /index.php;

    location @octane {
        set $suffix "";

        if ($uri = /index.php) {
            set $suffix ?$query_string;
        }

        proxy_http_version 1.1;
        proxy_set_header Host $http_host;
        proxy_set_header Scheme $scheme;
        proxy_set_header SERVER_PORT $server_port;
        proxy_set_header REMOTE_ADDR $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;

        proxy_pass http://127.0.0.1:8000$suffix;
    }
}

파일 변경 감지

Octane 서버가 시작될 때 애플리케이션이 메모리에 한 번만 로드되기 때문에, 파일을 수정해도 브라우저를 새로고침하는 것만으로는 변경사항이 반영되지 않습니다. 예를 들어 routes/web.php에 라우트를 추가해도 서버를 재시작하기 전까지는 적용되지 않습니다. 개발 편의를 위해 --watch 플래그를 사용하면 파일이 변경될 때마다 Octane이 서버를 자동으로 재시작합니다:

php artisan octane:start --watch

이 기능을 사용하려면 로컬 개발 환경에 Node가 설치되어 있어야 하며, 프로젝트에 Chokidar 파일 감시 라이브러리도 설치해야 합니다:

npm install --save-dev chokidar

감시할 디렉터리와 파일은 config/octane.php의 watch 설정 옵션으로 지정할 수 있습니다.

워커 수 지정

기본적으로 Octane은 머신의 CPU 코어 수만큼 요청 워커를 시작합니다. 이 워커들이 들어오는 HTTP 요청을 처리합니다. octane:start 명령어에 --workers 옵션을 사용해 워커 수를 직접 지정할 수 있습니다:

php artisan octane:start --workers=4

Swoole을 사용하는 경우 동시 작업을 위한 "태스크 워커" 수도 지정할 수 있습니다:

php artisan octane:start --workers=4 --task-workers=6

최대 요청 수 지정

메모리 누수를 방지하기 위해 Octane은 워커가 500개의 요청을 처리하면 자동으로 재시작합니다. --max-requests 옵션으로 이 값을 조정할 수 있습니다:

php artisan octane:start --max-requests=250

최대 실행 시간 지정

기본적으로 Laravel Octane은 config/octane.php의 max_execution_time 옵션을 통해 요청당 최대 실행 시간을 30초로 설정합니다:

'max_execution_time' => 30,

이 값은 요청이 강제 종료되기 전까지 허용되는 최대 실행 초를 정의합니다. 0으로 설정하면 실행 시간 제한이 비활성화됩니다. 파일 업로드, 데이터 처리, 외부 API 호출처럼 시간이 오래 걸리는 요청을 처리하는 애플리케이션에서 특히 유용한 옵션입니다.

WARNING

max_execution_time 설정을 변경한 경우 변경사항을 적용하려면 Octane 서버를 재시작해야 합니다.

워커 재시작

octane:reload 명령어로 Octane 서버의 애플리케이션 워커를 안전하게 재시작할 수 있습니다. 일반적으로 배포 후에 실행하여 새로 배포된 코드가 메모리에 로드되고 이후 요청에 적용되도록 합니다:

php artisan octane:reload

서버 중지

octane:stop Artisan 명령어로 Octane 서버를 중지할 수 있습니다:

php artisan octane:stop

서버 상태 확인

octane:status Artisan 명령어로 Octane 서버의 현재 상태를 확인할 수 있습니다:

php artisan octane:status

의존성 주입과 Octane

Octane은 애플리케이션을 한 번만 부팅하고 메모리에 유지한 채 요청을 처리하기 때문에, 애플리케이션을 구성할 때 몇 가지 주의사항을 숙지해야 합니다. 예를 들어, 서비스 프로바이더의 register와 boot 메서드는 요청 워커가 처음 기동될 때 단 한 번만 실행됩니다. 이후 요청에는 동일한 애플리케이션 인스턴스가 재사용됩니다.

이런 특성 때문에 애플리케이션 서비스 컨테이너나 요청(Request) 인스턴스를 객체의 생성자에 주입할 때 특별한 주의가 필요합니다. 잘못 주입하면 이후 요청에서 해당 객체가 오래된(stale) 컨테이너나 요청 인스턴스를 참조할 수 있습니다.

Octane은 요청 사이에 프레임워크 자체의 상태를 자동으로 초기화하지만, 애플리케이션이 직접 생성한 전역 상태까지 항상 초기화할 수는 없습니다. 따라서 Octane에 친화적인 방식으로 애플리케이션을 설계해야 합니다. 아래에서 자주 문제가 되는 상황을 살펴보겠습니다.

컨테이너 주입

일반적으로 애플리케이션 서비스 컨테이너나 HTTP Request 인스턴스를 다른 객체의 생성자에 주입하는 것은 피해야 합니다. 예를 들어 다음 바인딩은 싱글톤으로 등록된 객체에 전체 서비스 컨테이너를 주입합니다:

use App\Service;
use Illuminate\Contracts\Foundation\Application;

/**
 * 애플리케이션 서비스를 등록합니다.
 */
public function register(): void
{
    $this->app->singleton(Service::class, function (Application $app) {
        return new Service($app);
    });
}

이 예시에서 Service 인스턴스가 애플리케이션 부팅 중에 resolve되면, 그 시점의 컨테이너가 서비스에 주입됩니다. 이후 요청에서도 동일한 컨테이너가 유지되므로, 이후 부팅 사이클이나 다음 요청에서 추가된 바인딩이 누락될 수 있습니다.

이를 해결하려면 싱글톤 등록을 일반 바인딩으로 변경하거나, 항상 최신 컨테이너 인스턴스를 반환하는 클로저를 주입하면 됩니다:

use App\Service;
use Illuminate\Container\Container;
use Illuminate\Contracts\Foundation\Application;

$this->app->bind(Service::class, function (Application $app) {
    return new Service($app);
});

$this->app->singleton(Service::class, function () {
    return new Service(fn () => Container::getInstance());
});

전역 app 헬퍼와 Container::getInstance() 메서드는 항상 최신 애플리케이션 컨테이너를 반환하므로 안전하게 사용할 수 있습니다.

Request 주입

마찬가지로 HTTP Request 인스턴스를 싱글톤 객체의 생성자에 주입하는 것도 위험합니다. 다음 예시를 보겠습니다:

use App\Service;
use Illuminate\Contracts\Foundation\Application;

/**
 * 애플리케이션 서비스를 등록합니다.
 */
public function register(): void
{
    $this->app->singleton(Service::class, function (Application $app) {
        return new Service($app['request']);
    });
}

이 경우 Service 인스턴스가 부팅 중에 resolve되면 그 시점의 Request 인스턴스가 주입되고, 이후 모든 요청에서 해당 서비스는 오래된 Request를 참조하게 됩니다. 헤더, 입력값, 쿼리 스트링 등 모든 요청 데이터가 잘못 참조될 수 있습니다.

해결 방법은 싱글톤 등록을 해제하거나, 항상 현재 Request를 반환하는 클로저를 주입하거나, 가장 권장되는 방식으로 필요한 요청 데이터만 런타임에 메서드 인자로 직접 전달하는 것입니다:

use App\Service;
use Illuminate\Contracts\Foundation\Application;

$this->app->bind(Service::class, function (Application $app) {
    return new Service($app['request']);
});

$this->app->singleton(Service::class, function (Application $app) {
    return new Service(fn () => $app['request']);
});

// 또는 필요한 값만 메서드에 직접 전달...

$service->method($request->input('name'));

전역 request 헬퍼는 항상 현재 처리 중인 Request를 반환하므로 애플리케이션 어디서든 안전하게 사용할 수 있습니다.

WARNING

컨트롤러 메서드나 라우트 클로저에서 Illuminate\Http\Request 타입힌트를 사용하는 것은 문제없으며 권장되는 방식입니다.

설정 저장소 주입

설정 저장소 인스턴스를 객체의 생성자에 주입하는 것도 마찬가지로 주의해야 합니다. 예를 들어 다음 바인딩은 설정 저장소를 싱글톤 객체에 주입합니다:

use App\Service;
use Illuminate\Contracts\Foundation\Application;

/**
 * 애플리케이션 서비스를 등록합니다.
 */
public function register(): void
{
    $this->app->singleton(Service::class, function (Application $app) {
        return new Service($app->make('config'));
    });
}

요청 사이에 설정 값이 변경되더라도, 이 서비스는 최초 주입된 저장소 인스턴스에 의존하므로 변경된 값에 접근하지 못합니다.

해결 방법은 싱글톤 등록을 해제하거나, 항상 최신 설정 저장소를 반환하는 클로저를 주입하는 것입니다:

use App\Service;
use Illuminate\Container\Container;
use Illuminate\Contracts\Foundation\Application;

$this->app->bind(Service::class, function (Application $app) {
    return new Service($app->make('config'));
});

$this->app->singleton(Service::class, function () {
    return new Service(fn () => Container::getInstance()->make('config'));
});

전역 config 헬퍼는 항상 최신 설정 저장소를 반환하므로 안전하게 사용할 수 있습니다.

메모리 누수 관리

Octane은 요청 사이에도 애플리케이션을 메모리에 유지하기 때문에, 정적으로 유지되는 배열에 데이터를 계속 추가하면 메모리 누수가 발생합니다. 예를 들어 다음 컨트롤러는 요청마다 정적 $data 배열에 데이터를 계속 쌓으므로 메모리 누수를 일으킵니다:

use App\Service;
use Illuminate\Http\Request;
use Illuminate\Support\Str;

/**
 * 들어오는 요청을 처리합니다.
 */
public function index(Request $request): array
{
    Service::$data[] = Str::random(10);

    return [
        // ...
    ];
}

애플리케이션을 개발할 때는 이러한 메모리 누수가 생기지 않도록 주의해야 합니다. 로컬 개발 중에는 애플리케이션의 메모리 사용량을 모니터링하여 새로운 메모리 누수가 발생하지 않는지 확인하는 것이 좋습니다.

동시 작업

WARNING

이 기능은 Swoole이 필요합니다.

Swoole을 사용하면 경량 백그라운드 태스크를 통해 작업을 동시에 실행할 수 있습니다. Octane의 concurrently 메서드를 사용하면 되고, PHP 배열 구조 분해를 결합해 각 작업의 결과를 받을 수 있습니다:

use App\Models\User;
use App\Models\Server;
use Laravel\Octane\Facades\Octane;

[$users, $servers] = Octane::concurrently([
    fn () => User::all(),
    fn () => Server::all(),
]);

Octane의 동시 작업은 Swoole의 "태스크 워커"를 활용하며, 들어오는 요청과는 완전히 다른 프로세스에서 실행됩니다. 동시 작업에 사용할 수 있는 워커 수는 octane:start 명령어의 --task-workers 옵션으로 지정합니다:

php artisan octane:start --workers=4 --task-workers=6

concurrently 메서드를 호출할 때는 Swoole 태스크 시스템의 제한으로 인해 1024개를 초과하는 태스크를 전달하지 않아야 합니다.

틱과 인터벌

WARNING

이 기능은 Swoole이 필요합니다.

Swoole을 사용하면 지정한 초마다 실행될 "틱(tick)" 작업을 등록할 수 있습니다. tick 메서드로 틱 콜백을 등록하며, 첫 번째 인자는 틱의 이름(문자열), 두 번째 인자는 지정한 인터벌마다 호출될 callable입니다.

다음 예시는 10초마다 클로저를 실행하도록 등록합니다. tick 메서드는 보통 서비스 프로바이더의 boot 메서드 안에서 호출합니다:

Octane::tick('simple-ticker', fn () => ray('Ticking...'))
    ->seconds(10);

immediate 메서드를 사용하면 Octane 서버가 처음 부팅될 때 즉시 틱 콜백을 실행하고, 이후 N초마다 반복 실행하도록 지시할 수 있습니다:

Octane::tick('simple-ticker', fn () => ray('Ticking...'))
    ->seconds(10)
    ->immediate();

Octane 캐시

WARNING

이 기능은 Swoole이 필요합니다.

Swoole을 사용하면 초당 최대 200만 번의 읽기/쓰기 속도를 제공하는 Octane 캐시 드라이버를 활용할 수 있습니다. 캐시 레이어에서 극단적인 읽기/쓰기 속도가 필요한 애플리케이션에 탁월한 선택입니다.

이 캐시 드라이버는 Swoole 테이블로 구동됩니다. 캐시에 저장된 데이터는 서버의 모든 워커에서 접근할 수 있습니다. 단, 서버가 재시작되면 캐시 데이터는 초기화됩니다:

Cache::store('octane')->put('framework', 'Laravel', 30);

NOTE

Octane 캐시에 허용되는 최대 항목 수는 애플리케이션의 octane 설정 파일에서 정의할 수 있습니다.

캐시 인터벌

Laravel 캐시 시스템의 일반적인 메서드 외에도, Octane 캐시 드라이버는 인터벌 기반 캐시를 제공합니다. 이 캐시는 지정한 인터벌마다 자동으로 갱신되며, 서비스 프로바이더의 boot 메서드에서 등록해야 합니다. 다음 예시는 5초마다 캐시를 갱신합니다:

use Illuminate\Support\Str;

Cache::store('octane')->interval('random', function () {
    return Str::random(10);
}, seconds: 5);

테이블

WARNING

이 기능은 Swoole이 필요합니다.

Swoole을 사용하면 직접 정의한 Swoole 테이블을 자유롭게 활용할 수 있습니다. Swoole 테이블은 매우 높은 처리 성능을 제공하며, 저장된 데이터는 서버의 모든 워커에서 접근할 수 있습니다. 단, 서버가 재시작되면 테이블 내 데이터는 삭제됩니다.

테이블은 octane 설정 파일의 tables 배열에 정의합니다. 아래와 같이 최대 1000개의 행을 허용하는 예시 테이블이 기본으로 구성되어 있습니다. 문자열 컬럼의 최대 크기는 컬럼 타입 뒤에 크기를 붙여 지정합니다:

'tables' => [
    'example:1000' => [
        'name' => 'string:1000',
        'votes' => 'int',
    ],
],

테이블에 접근하려면 Octane::table 메서드를 사용합니다:

use Laravel\Octane\Facades\Octane;

Octane::table('example')->set('uuid', [
    'name' => 'Nuno Maduro',
    'votes' => 1000,
]);

return Octane::table('example')->get('uuid');

WARNING

Swoole 테이블이 지원하는 컬럼 타입은 string, int, float입니다.