CakeFest 2024: The Official CakePHP Conference

fclose

(PHP 4, PHP 5, PHP 7, PHP 8)

fcloseオープンされたファイルポインタをクローズする

説明

fclose(resource $stream): bool

streamが指しているファイルをクローズします。

パラメータ

stream

ファイルポインタは有効なものでなければならず、また fopen()またはfsockopen() で正常にオープンされたファイルを指している必要があります。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例1 シンプルな fclose() の例

<?php

$handle
= fopen('somefile.txt', 'r');

fclose($handle);

?>

参考

  • fopen() - ファイルまたは URL をオープンする
  • fsockopen() - インターネット接続もしくは Unix ドメインソケット接続をオープンする

add a note

User Contributed Notes 7 notes

up
28
jricher at jacquesricher dot com
19 years ago
It is a GOOD_THING to check the return value from fclose(), as some operating systems only flush file output on close, and can, therefore, return an error from fclose(). You can catch severe data-eating errors by doing this.

I learned this the hard way.
up
7
daniel7 dot martinez at ps dot ge dot com
22 years ago
Generally, it's always a good idea to close a file when you're done with it. It's very easy for something to go wrong and corrupt a file that hasn't been closed properly. If you're concerned about efficiency, the overhead is negligible.
up
1
Glenn S
1 year ago
Note that from PHP 8.0 onwards, attempting to close a stream that is already closed will throw a fatal TypeError.

Prior to PHP 8, this just caused a warning (that you can silence with @).
up
5
jgotti
11 years ago
In case you have some trouble to properly disconnect some client streams opened with stream_socket_server / stream_select you should give a try to stream_socket_shutdown.

<?php stream_socket_shutdown($clientStream,STREAM_SHUT_RDWR); ?>
up
1
tom dot vom dot berg at online dot de
9 years ago
if you want to daysychain a filehandle through some functions and each function is allowed to close th file you might look in a following function first, if the handle is still valid.

Opening a file, there often will be used a code like

if (!$fh = fopen($filename, $mode)) return false;

But if you possably have closed the file and you want to check that, a smililar statement would not work.

DOES NOT WORK: if (!$fh) end_of_chain();

use beter: if (is_resource($fh)) end_of_chain();
up
-1
mark at markvange * com
17 years ago
It is very important to make sure you clear any incoming packets out of the incoming buffer using fread() or some equivalent. Although you can call fclose() the socket does not actually shut down until the inbound packets have been cleared. This can lead to some confusion.
up
-6
James R. Steel
18 years ago
In response to kumar mcmillan 'gotcha' note below, we get a different result on a W2K machine:

<?php
$file_pointer
= fopen('textfile.dat', 'r');
fclose($file_pointer);
echo
'$file_pointer is resource = ' . (is_resource($file_pointer) ? 'true': 'false');
?>

output:
$file_pointer is resource = false
To Top