컴포넌트ThreadPool::getWorkerCount()

ThreadPool::getWorkerCount() ​

(PHP 8.6+, True Async 1.0)

php
public ThreadPool::getWorkerCount(): int

현재 풀에서 실행 중인 워커 스레드 수를 반환합니다. new ThreadPool()에 전달된 $workers 인수에서 시작하며, 워커가 종료될 때마다 줄어듭니다.

반환값 ​

int — 현재 실행 중인 워커 스레드 수입니다. 워커는 스레드가 종료되면 이 수에서 빠지므로, 풀이 닫히고 워커가 모두 종료되면 0을 반환하며, 스레드를 하나 잃은 풀은 생성 시점보다 하나 적은 수를 반환합니다.

예제 ​

예제 #1 워커 수 확인 ​

php
<?php

use Async\ThreadPool;
use function Async\spawn;

spawn(function() {
    $pool = new ThreadPool(workers: 4);

    echo $pool->getWorkerCount(), "\n"; // 4

    $pool->close();
});

예제 #2 사용 가능한 CPU 코어에 맞게 풀 크기 조정 ​

php
<?php

use Async\ThreadPool;
use function Async\spawn;
use function Async\await;

spawn(function() {
    $cores = (int) shell_exec('nproc') ?: 4;
    $pool  = new ThreadPool(workers: $cores);

    echo "Pool created with ", $pool->getWorkerCount(), " workers\n";

    $futures = [];
    for ($i = 0; $i < $cores * 2; $i++) {
        $futures[] = $pool->submit(fn() => 'done');
    }
    foreach ($futures as $f) {
        await($f);
    }

    $pool->close();
});

참고 ​