PHP 7.4.3 released

get_resource_type

(PHP 4 >= 4.0.2, PHP 5, PHP 7)

get_resource_typeリソース型を返す

説明

get_resource_type ( resource $handle ) : string

この関数は、指定したリソースの型を取得します。

パラメータ

handle

評価されるリソースハンドル。

返り値

指定された handle がリソースであった場合、 この関数はその型を表す文字列を返します。この関数で型が判別できなかった 場合は、返り値は文字列 Unknown となります。

もし handle がリソースでない場合、 この関数は NULL を返し、エラーを発生させます。

変更履歴

バージョン 説明
5.3.0 handleresource でなかった場合、 この関数は NULL を返すようになりました。 これより前のバージョンでは、FALSE を返していました。

例1 get_resource_type() の例

<?php
// mysql link を出力
$c mysql_connect();
echo 
get_resource_type($c) . "\n";

// stream を出力
$fp fopen("foo""w");
echo 
get_resource_type($fp) . "\n";

// domxml document を出力
$doc new_xmldoc("1.0");
echo 
get_resource_type($doc->doc) . "\n";
?>

add a note add a note

User Contributed Notes 4 notes

up
11
CertaiN
6 years ago
Try this to know behavior:

<?php
function resource_test($resource, $name) {
    echo
       
'[' . $name. ']',
       
PHP_EOL,
       
'(bool)$resource => ',
       
$resource ? 'TRUE' : 'FALSE',
       
PHP_EOL,
       
'get_resource_type($resource) => ',
       
get_resource_type($resource) ?: 'FALSE',
       
PHP_EOL,
       
'is_resoruce($resource) => ',
       
is_resource($resource) ? 'TRUE' : 'FALSE',
       
PHP_EOL,
       
PHP_EOL
   
;
}

$resource = tmpfile();
resource_test($resource, 'Check Valid Resource');

fclose($resource);
resource_test($resource, 'Check Released Resource');

$resource = null;
resource_test($resource, 'Check NULL');
?>

It will be shown as...

[Check Valid Resource]
(bool)$resource => TRUE
get_resource_type($resource) => stream
is_resoruce($resource) => TRUE

[Check Released Resource]
(bool)$resource => TRUE
get_resource_type($resource) => Unknown
is_resoruce($resource) => FALSE

[Check NULL]
(bool)$resource => FALSE
get_resource_type($resource) => FALSE
Warning:  get_resource_type() expects parameter 1 to be resource, null given in ... on line 10
is_resoruce($resource) => FALSE
up
-8
jdhawk _at_ gmail
14 years ago
In PHP5 (on Linux), the above example identifies the "file" handler as a 'stream', not 'file'.

This can be particularly worrisome if you're trying to determine the type of stream using this function.

The alternative is to use <?php stream_get_meta_data() ?>, which returns an array containing "stream_type (string) - a label describing the underlying implementation of the stream."
up
-18
hessodreamy at gmail dot com
12 years ago
Furthermore, this function returns 'stream' on php 4.3 on windows & linux.
You if you want to differentiate between a file resource and other stream resources, as stated before stream_get_meta_data() gives you an array which, on my system, contains the following elements which might suggest a file handle:
[wrapper_type] => plainfile
[stream_type] => STDIO

However I've only compared this to a stream from a url, so I include this only as a suggestion.
up
-26
avp200681 at gmail dot com
8 years ago
This function will generate an error and return NULL instead FALSE in the next example:

<?php

$var
= 3;
var_dump(get_resource_type($var));

?>
To Top