Laravel queue:work not working on Windows

1
2
3
4
5

# queue:work（推奨されるが、Windowsで問題あり）
php artisan queue:work

# queue:listen（Windowsで動作しやすい）
php artisan queue:listen --timeout=60 --sleep=3 --tries=3

1
2
3
4
5

// .env（開発環境）
QUEUE_CONNECTION=sync

// config/queue.php
'default' => env('QUEUE_CONNECTION', 'sync'),

1
2
3
4

# タスクスケジューラで定期実行
# PowerShellスクリプト: run-queue.ps1
cd C:\path\to\laravel
php artisan queue:work --stop-when-empty --max-jobs=100

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# NSSMをインストール
# https://nssm.cc/download からダウンロード

# サービスとして登録
nssm install LaravelWorker

# サービス設定
# Path: C:\php\php.exe
# Startup directory: C:\path\to\laravel
# Arguments: artisan queue:work --sleep=3 --tries=3

1
2
3
4
5

@echo off
:loop
php artisan queue:work --stop-when-empty --max-jobs=50
timeout /t 5 /nobreak
goto loop

1
2
3
4
5
6

// .env
QUEUE_CONNECTION=database

// マイグレーション作成
php artisan queue:table
php artisan migrate

1
2
3
4
5
6
7

// config/queue.php
'database' => [
    'driver' => 'database',
    'table' => 'jobs',
    'queue' => 'default',
    'retry_after' => 90,
],

1
2
3
4
5
6

# WSLをインストール
wsl --install

# WSL内でLaravelを実行
cd /mnt/c/path/to/laravel
php artisan queue:work

1
2
3
4
5

# Redisをインストール（Windows版またはWSL経由）
# https://github.com/microsoftarchive/redis/releases

# または Memurai（Windows用Redis互換）
# https://www.memurai.com/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

// .env
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

// config/queue.php
'redis' => [
    'driver' => 'redis',
    'connection' => 'default',
    'queue' => env('REDIS_QUEUE', 'default'),
    'retry_after' => 90,
    'block_for' => null,
],

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// app/Console/Commands/WindowsWorker.php
namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Artisan;

class WindowsWorker extends Command
{
    protected $signature = 'windows:worker {--max-jobs=100}';
    protected $description = 'Windows compatible queue worker';

    public function handle(): void
    {
        while (true) {
            $this->info('Processing queue...');

            Artisan::call('queue:work', [
                '--stop-when-empty' => true,
                '--max-jobs' => $this->option('max-jobs'),
            ]);

            $this->info(Artisan::output());

            sleep(5);
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# docker-compose.yml
version: '3'
services:
  app:
    build: .
    volumes:
      - .:/var/www/html
    depends_on:
      - redis

  worker:
    build: .
    command: php artisan queue:work --sleep=3 --tries=3
    volumes:
      - .:/var/www/html
    depends_on:
      - redis

  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

1
2
3
4
5
6

// 開発環境でのみ同期的に実行
if (app()->environment('local')) {
    ProcessPodcast::dispatchSync($podcast);
} else {
    ProcessPodcast::dispatch($podcast);
}

1
2
3
4
5
6
7
8

# キューの状態確認
php artisan queue:failed

# ジョブを手動で実行（デバッグ）
php artisan queue:work --once

# 詳細ログを出力
php artisan queue:work -vvv

1
2
3
4
5
6
7

// ジョブ内でログ出力
public function handle(): void
{
    \Log::info('Job started', ['job_id' => $this->job->getJobId()]);
    // 処理
    \Log::info('Job completed');
}