Get resource id: примеры (PHP)

Идентификатор открытого файлового дескриптора.

$file = fopen('test.txt', 'r');
$id = get_resource_id($file);
var_dump($id);
// Ресурс будет автоматически закрыт при завершении скрипта
// или можно закрыть явно: fclose($file);

int(5)

Пример с сетевым подключением.

$socket = stream_socket_client('tcp://google.com:80');
if ($socket) {
    echo get_resource_id($socket);
    fclose($socket);
}

6

Функция выбрасывает TypeError, если передан не ресурс.

try {
    $id = get_resource_id('not_a_resource');
} catch (TypeError $e) {
    echo $e->getMessage();
}

get_resource_id(): Argument #1 ($resource) must be of type resource, string given

В PHP есть несколько функций для работы с ресурсами, но прямая замена get_resource_id() отсутствует.

Проверяет, является ли переменная ресурсом. Не возвращает идентификатор.

$file = fopen('php://memory', 'r');
var_dump(is_resource($file));

bool(true)

Возвращает массив всех активных ресурсов в системе. Может быть отфильтрован по типу. Возвращает массив ресурсов, а не их идентификаторы.

$file = fopen('php://memory', 'w');
$allResources = get_resources();
print_r($allResources);

Array
(
    [5] => stream resource
)

Выбор функции: get_resource_id() следует использовать, когда необходим именно целочисленный идентификатор для сравнения или логирования. is_resource() применяется для проверки типа переменной. get_resources() полезна для отладки и мониторинга.

Get resource id в Python

В Python функция id() возвращает уникальный идентификатор (целое число) для любого объекта, который постоянен на протяжении его жизни. Аналог более универсальный, так как тип «ресурс» в Python отсутствует.

file_obj = open('test.txt', 'r')
print(id(file_obj))
file_obj.close()

140248640725040

В JavaScript отсутствует прямой аналог. Для файловых дескрипторов в среде Node.js используются числовые идентификаторы, возвращаемые методами вроде fs.openSync(). Они уже являются числами.

const fs = require('fs');
const fd = fs.openSync('test.txt', 'r');
console.log(fd); // Это уже число
fs.closeSync(fd);

3

Get resource id в MySQL

В MySQL нет прямой аналогии на уровне языка запросов. Идентификаторы соединений (Thread ID) можно получить через функцию CONNECTION_ID(), но это относится к сессии, а не к произвольному ресурсу.

SELECT CONNECTION_ID();

+-----------------+
| CONNECTION_ID() |
+-----------------+
|             123 |
+-----------------+

Таким образом, get_resource_id() в PHP является специализированной функцией для работы с внутренним типом «resource».

Наиболее частая ошибка — попытка получить идентификатор у переменной, которая не является ресурсом. В PHP 8 это приводит к исключению TypeError.

// Ошибка: передача NULL
$id = get_resource_id(null);

TypeError: get_resource_id(): Argument #1 ($resource) must be of type resource, null given

После закрытия ресурса (например, с помощью fclose) его идентификатор может быть переиспользован для нового ресурса. Сравнение идентификаторов, сохраненных ранее, может привести к логическим ошибкам.

$file1 = fopen('test1.txt', 'r');
$id1 = get_resource_id($file1);
fclose($file1);

$file2 = fopen('test2.txt', 'r');
$id2 = get_resource_id($file2);

// $id1 может быть равно $id2, если система переиспользовала номер.
var_dump($id1, $id2);

int(5)
int(5)

Идентификаторы уникальны в рамках одного процесса, но система нумерации может быть общей для всех типов ресурсов. Не следует полагаться на префиксы или специальные диапазоны для разных типов.

Функция get_resource_id() была добавлена в PHP 8.0. До этой версии разработчики часто использовали неявное приведение ресурса к целому числу, что было неочевидно и считалось плохой практикой.

// До PHP 8.0 (устаревший способ)
$file = fopen('test.txt', 'r');
$id = (int) $file; // или $id = $file;
echo $id;
fclose($file);

Начиная с PHP 8.0, приведение ресурса к целому числу или строке вызывает ошибку уровня E_WARNING. Поэтому get_resource_id() стала единственным корректным способом получения идентификатора.

// Начиная с PHP 8.0
$file = fopen('test.txt', 'r');
// $id = (int) $file; // Warning: Resource ID#5 used as int
$id = get_resource_id($file); // Правильный способ

Идентификаторы позволяют сравнивать, ссылаются ли две переменные на один и тот же ресурс.

$file1 = fopen('php://memory', 'w');
$file2 = $file1; // Присваивание по ссылке
$file3 = fopen('php://memory', 'w');

var_dump(
    get_resource_id($file1) === get_resource_id($file2),
    get_resource_id($file1) === get_resource_id($file3)
);

bool(true)
bool(false)

Идентификаторы удобно использовать для отладочных сообщений или логирования.

function openConnection($host) {
    $socket = stream_socket_client($host);
    if (!$socket) {
        throw new Exception("Connection failed");
    }
    $id = get_resource_id($socket);
    error_log("Открыто сетевое соединение [ID: $id] с $host");
    return $socket;
}

Идентификаторы можно использовать как ключи или для поиска в массиве ресурсов.

$connections = [];

$conn1 = fopen('php://memory', 'r');
$connections[get_resource_id($conn1)] = ['type' => 'memory', 'created' => time()];

$conn2 = fopen('php://temp', 'r');
$connections[get_resource_id($conn2)] = ['type' => 'temp', 'created' => time()];

print_r($connections);

// Быстрая проверка существования ресурса в массиве по ID
$idToFind = get_resource_id($conn1);
if (isset($connections[$idToFind])) {
    echo "Ресурс с ID $idToFind найден.\n";
}

Array
(
    [5] => Array
        (
            [type] => memory
            [created] => 1678901234
        )
    [6] => Array
        (
            [type] => temp
            [created] => 1678901234
        )
)
Ресурс с ID 5 найден.

Функция работает и с ресурсами, созданными расширениями PHP.

// Пример с модулем curl (если установлен)
$ch = curl_init('https://example.com');
if (is_resource($ch) || $ch instanceof \CurlHandle) {
    // В PHP 8.0+ curl_init может возвращать объект CurlHandle
    // Для ресурса получим ID, для объекта — нет.
    if (is_resource($ch)) {
        echo 'ID ресурса cURL: ' . get_resource_id($ch);
    }
    curl_close($ch);
}