Php как записать в файл

file_put_contents

Функция идентична последовательным успешным вызовам функций fopen() , fwrite() и fclose() .

Если filename не существует, файл будет создан. Иначе, существующий файл будет перезаписан, за исключением случая, если указан флаг FILE_APPEND .

Список параметров

Путь к записываемому файлу.

Записываемые данные. Может быть типа string , array или ресурсом потока.

Если data является потоковым ресурсом ( stream ), оставшийся буфер этого потока будет скопирован в указанный файл. Это похоже на использование функции stream_copy_to_stream() .

Также вы можете передать одномерный массив в качестве параметра data . Это будет эквивалентно вызову file_put_contents($filename, implode('', $array)) .

Значением параметра flags может быть любая комбинация следующих флагов, соединённых бинарным оператором ИЛИ ( | ).

Доступные флаги

Флаг	Описание
FILE_USE_INCLUDE_PATH	Ищет filename в подключаемых директориях. Подробнее смотрите директиву include_path.
FILE_APPEND	Если файл filename уже существует, данные будут дописаны в конец файла вместо того, чтобы его перезаписать.
LOCK_EX	Получить эксклюзивную блокировку на файл на время записи. Другими словами, между вызовами fopen() и fwrite() произойдёт вызов функции flock() . Это не одно и то же, что вызов fopen() с флагом "x".

Корректный ресурс контекста, созданный с помощью функции stream_context_create() .

Возвращаемые значения

Функция возвращает количество записанных байт в файл, или false в случае возникновения ошибки.

Эта функция может возвращать как логическое значение false , так и значение не типа boolean, которое приводится к false . За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

Примеры

Пример #1 Пример простого использования

Пример #2 Использование флагов

Примечания

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen wrappers. Смотрите более подробную информацию об определении имени файла в описании функции fopen() . Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по использованию и список предопределённых констант в разделе Поддерживаемые протоколы и обёртки.

Смотрите также

• fopen() — Открывает файл или URL
• fwrite() — Бинарно-безопасная запись в файл
• file_get_contents() — Читает содержимое файла в строку
• stream_context_create() — Создаёт контекст потока

User Contributed Notes 37 notes

File put contents fails if you try to put a file in a directory that doesn’t exist. This creates the directory.

<?php
function file_force_contents ( $dir , $contents ) <
$parts = explode ( ‘/’ , $dir );
$file = array_pop ( $parts );
$dir = » ;
foreach( $parts as $part )
if(! is_dir ( $dir .= «/ $part » )) mkdir ( $dir );
file_put_contents ( » $dir / $file » , $contents );
>
?>

It should be obvious that this should only be used if you’re making one write, if you are writing multiple times to the same file you should handle it yourself with fopen and fwrite, the fclose when you are done writing.

file_put_contents() for 1,000,000 writes — average of 3 benchmarks:

real 0m3.932s
user 0m2.487s
sys 0m1.437s

fopen() fwrite() for 1,000,000 writes, fclose() — average of 3 benchmarks:

real 0m2.265s
user 0m1.819s
sys 0m0.445s

<?php
function file_force_contents ( $fullPath , $contents , $flags = 0 ) <
$parts = explode ( ‘/’ , $fullPath );
array_pop ( $parts );
$dir = implode ( ‘/’ , $parts );

if( ! is_dir ( $dir ) )
mkdir ( $dir , 0777 , true );

file_put_contents ( $fullPath , $contents , $flags );
>

file_force_contents ( ROOT . ‘/newpath/file.txt’ , ‘message’ , LOCK_EX );
?>

Please note that when saving using an FTP host, an additional stream context must be passed through telling PHP to overwrite the file.

<?php
/* set the FTP hostname */
$user = «test» ;
$pass = «myFTP» ;
$host = «example.com» ;
$file = «test.txt» ;
$hostname = $user . «:» . $pass . «@» . $host . «/» . $file ;

/* the file content */
$content = «this is just a test.» ;

/* create a stream context telling PHP to overwrite the file */
$options = array( ‘ftp’ => array( ‘overwrite’ => true ));
$stream = stream_context_create ( $options );

/* and finally, put the contents */
file_put_contents ( $hostname , $content , 0 , $stream );
?>

It’s important to understand that LOCK_EX will not prevent reading the file unless you also explicitly acquire a read lock (shared locked) with the PHP ‘flock’ function.

i.e. in concurrent scenarios file_get_contents may return empty if you don’t wrap it like this:

<?php
$myfile = fopen ( ‘test.txt’ , ‘rt’ );
flock ( $myfile , LOCK_SH );
$read = file_get_contents ( ‘test.txt’ );
fclose ( $myfile );
?>

If you have code that does a file_get_contents on a file, changes the string, then re-saves using file_put_contents, you better be sure to do this correctly or your file will randomly wipe itself out.

Make sure not to corrupt anything in case of failure.

function file_put_contents_atomically ( $filename , $data , $flags = 0 , $context = null ) <
if ( file_put_contents ( $filename . «

» , $data , $flags , $context ) === strlen ( $contents )) <
return rename ( $filename . «

» , $context );
return FALSE ;
>

In reply to the previous note:

If you want to emulate this function in PHP4, you need to return the bytes written as well as support for arrays, flags.

I can only figure out the FILE_APPEND flag and array support. If I could figure out «resource context» and the other flags, I would include those too.

define(‘FILE_APPEND’, 1);
function file_put_contents($n, $d, $flag = false) <
$mode = ($flag == FILE_APPEND || strtoupper($flag) == ‘FILE_APPEND’) ? ‘a’ : ‘w’;
$f = @fopen($n, $mode);
if ($f === false) <
return 0;
> else <
if (is_array($d)) $d = implode($d);
$bytes_written = fwrite($f, $d);
fclose($f);
return $bytes_written;
>
>

I suggest to expand file_force_contents() function of TrentTompkins at gmail dot com by adding verification if patch is like: «../foo/bar/file»

if (strpos($dir, «../») === 0)
$dir = str_replace(«..», substr(__DIR__, 0, strrpos(__DIR__, «/»)), $dir);

This functionality is now implemented in the PEAR package PHP_Compat.

More information about using this function without upgrading your version of PHP can be found on the below link:

To upload file from your localhost to any FTP server.
pease note ‘ftp_chdir’ has been used instead of putting direct remote file path. in ftp_put . remoth file should be only file name

<?php
$host = ‘*****’ ;
$usr = ‘*****’ ;
$pwd = ‘**********’ ;
$local_file = ‘./orderXML/order200.xml’ ;
$ftp_path = ‘order200.xml’ ;
$conn_id = ftp_connect ( $host , 21 ) or die ( «Cannot connect to host» );
ftp_pasv ( $resource , true );
ftp_login ( $conn_id , $usr , $pwd ) or die( «Cannot login» );
// perform file upload
ftp_chdir ( $conn_id , ‘/public_html/abc/’ );
$upload = ftp_put ( $conn_id , $ftp_path , $local_file , FTP_ASCII );
if( $upload ) < $ftpsucc = 1 ; >else < $ftpsucc = 0 ; >
// check upload status:
print (! $upload ) ? ‘Cannot upload’ : ‘Upload complete’ ;
print «\n» ;
// close the FTP stream
ftp_close ( $conn_id );
?>

I’m updating a function that was posted, as it would fail if there was no directory. It also returns the final value so you can determine if the actual file was written.

public static function file_force_contents($dir, $contents) <
$parts = explode(‘/’, $dir);
$file = array_pop($parts);
$dir = »;

foreach($parts as $part) <
if (! is_dir($dir .= «<$part>/»)) mkdir($dir);
>

return file_put_contents(«<$dir><$file>«, $contents);
>

File put contents fails if you try to put a file in a directory that doesn’t exist. This function creates the directory.

i have updated code of «TrentTompkins at gmail dot com». thanks
<?php
/**
* @param string $filename <p>file name including folder.
* example :: /path/to/file/filename.ext or filename.ext</p>
* @param string $data <p> The data to write.
* </p>
* @param int $flags same flags used for file_put_contents.
* more info: http://php.net/manual/en/function.file-put-contents.php
* @return bool <b>TRUE</b> file created succesfully <br> <b>FALSE</b> failed to create file.
*/
function file_force_contents ( $filename , $data , $flags = 0 ) <
if(! is_dir ( dirname ( $filename )))
mkdir ( dirname ( $filename ). ‘/’ , 0777 , TRUE );
return file_put_contents ( $filename , $data , $flags );
>
// usage

file_force_contents ( ‘test1.txt’ , ‘test1 content’ ); // test1.txt created

file_force_contents ( ‘test2/test2.txt’ , ‘test2 content’ );
// test2/test2.txt created «test2» folder.

/test3/test3.txt’ , ‘test3 content’ );
// /path/to/user/directory/test3/test3.txt created «test3» folder in user directory (check on linux «ll

It’s worth noting that you must make sure to use the correct path when working with this function. I was using it to help with logging in an error handler and sometimes it would work — while other times it wouldn’t. In the end it was because sometimes it was called from different paths resulting in a failure to write to the log file.

__DIR__ is your friend.

A more simplified version of the method that creates subdirectories:

function path_put_contents($filePath, $contents, $flags = 0) <

if (! is_dir($dir = implode(‘/’, explode(‘/’, $filePath, -1))))
mkdir($dir, 0777, true);
file_put_contents($filePath, $contents, $flags);
>

I use file_put_contents() as a method of very simple hit counters. These are two different examples of extremely simple hit counters, put on one line of code, each.

Keep in mind that they’re not all that efficient. You must have a file called counter.txt with the initial value of 0.

For a text hit counter:
<?php
$counter = file_get_contents ( «counter.txt» ); $counter ++; file_put_contents ( «counter.txt» , $counter ); echo $counter ;
?>

Or a graphic hit counter:
<?php
$counter = file_get_contents ( «counter.txt» ); $counter ++; file_put_contents ( «counter.txt» , $counter ); for( $i = 0 ; $i < strlen ( $counter ); $i ++) echo «<img src=\»counter/» . substr ( $counter , $i , 1 ). «.gif\» alt=\»» . substr ( $counter , $i , 1 ). «\» />» ;
?>

file_put_contents() strips the last line ending

If you really want an extra line ending at the end of a file when writing with file_put_contents(), you must append an extra PHP_EOL to the end of the line as follows.

<?php
$a_str = array( «these» , «are» , «new» , «lines» );
$contents = implode ( PHP_EOL , $a_str );
$contents .= PHP_EOL . PHP_EOL ;
file_put_contents ( «newfile.txt» , $contents );
print( «| $contents |» );
?>

You can see that when you print $contents you get two extra line endings, but if you view the file newfile.txt, you only get one.

I faced the problem of converting a downloaded csv file that had Windows-1252 encoding, so to convert it to UTF-8 this worked for me:

$from = ‘Windows-1252’;
$to = ‘UTF-8’;

file_put_contents($this->path(), mb_convert_encoding($content, $to, $from));

where «$this->path()» has the path of the file. Using this the file is converted from Windows-1252 to UTF-8.

With this you can import it with mysqlimport with no problems.

Here is a stupid pitfall I just fell into.
I think it may happen rather frequently, so I report it.

A common situation is that the $filename argument is built from two variables:
file_put_contents($path . $file, $content);

Say that $path = ‘path/to’ and $file = ‘file.txt’: you see that $path lacks its ending «/», so the resulting full path is ‘path/tofile.txt’.

Then you look at ‘path/to’ and don’t see any ‘file.txt’, although no warning or notice was thrown!
And may be (like for me :D) it’ll take time before you realize that a bad ‘tofile.txt’ was created in the *parent* directory of the one where you were looking for your file.

I wrote this script implementing the file_put_contents() and file_get_contents() functions to be compatible with both php4.* and php 5.*. It is a PHP Command line interface script which searches and replaces a specific word recursively through all files in the supplied directory hierarchy.

Usage from a Linux command line: ./scriptname specifieddirectory searchString replaceString

#!/usr/bin/php
<?php
$argc = $_SERVER [ ‘argc’ ];
$argv = $_SERVER [ ‘argv’ ];

if( $argc != 4 )
<
echo «This command replaces a search string with a replacement string\n for the contents of all files in a directory hierachy\n» ;
echo «command usage: $argv [ 0 ] directory searchString replaceString\n» ;
echo «\n» ;
exit;
>
?><?php

if (! function_exists ( ‘file_put_contents’ )) <
function file_put_contents ( $filename , $data ) <
$f = @ fopen ( $filename , ‘w’ );
if (! $f ) <
return false ;
> else <
$bytes = fwrite ( $f , $data );
fclose ( $f );
return $bytes ;
>
>
>

function get_file_contents ( $filename )

/* Returns the contents of file name passed

*/
<
if (! function_exists ( ‘file_get_contents’ ))
<
$fhandle = fopen ( $filename , «r» );
$fcontents = fread ( $fhandle , filesize ( $filename ));
fclose ( $fhandle );
>
else
<
$fcontents = file_get_contents ( $filename );
>
return $fcontents ;
>
?><?php

function openFileSearchAndReplace ( $parentDirectory , $searchFor , $replaceWith )
<
//echo «debug here- line 1a\n»;
//echo «$parentDirectory\n»;
//echo «$searchFor\n»;
//echo «$replaceWith\n»;

if ( $handle = opendir ( » $parentDirectory » )) <
while ( false !== ( $file = readdir ( $handle ))) <
if (( $file != «.» && $file != «..» ) && ! is_dir ( $file )) <
chdir ( » $parentDirectory » ); //to make sure you are always in right directory
// echo «$file\n»;
$holdcontents = file_get_contents ( $file );
$holdcontents2 = str_replace ( $searchFor , $replaceWith , $holdcontents );
file_put_contents ( $file , $holdcontents2 );
// echo «debug here- line 1\n»;
// echo «$file\n»;

>
if( is_dir ( $file ) && ( $file != «.» && $file != «..» ))
<
$holdpwd = getcwd ();
//echo «holdpwd = $holdpwd \n»;
$newdir = » $holdpwd » . «/ $file » ;
//echo «newdir = $newdir \n»; //for recursive call
openFileSearchAndReplace ( $newdir , $searchFor , $replaceWith );
//echo «debug here- line 2\n»;
//echo «$file\n»;
>
>
closedir ( $handle );
>
>

$parentDirectory2 = $argv [ 1 ];
$searchFor2 = $argv [ 2 ];
$replaceWith2 = $argv [ 3 ];

//Please do not edit below to keep the rights to this script
//Free license, if contents below this line is not edited
echo «REPLACED\n’ $searchFor2 ‘ with ‘ $replaceWith2 ‘ recursively through directory listed below\nFor all files that current user has write permissions for\nDIRECTORY: ‘ $parentDirectory2 ‘\n» ;
echo «command written by Kolapo Akande 🙂 all rights reserved :)\n» ;

$holdpwd = getcwd ();
//echo «$holdpwd\n»;
chdir ( $parentDirectory2 );
openFileSearchAndReplace ( $parentDirectory2 , $searchFor2 , $replaceWith2 );
exit;
?>

As to the previous user note, it would be wise to include that code within a conditional statement, as to prevent re-defining file_put_contents and the FILE_APPEND constant in PHP 5:

<?php
if ( ! function_exists ( ‘file_put_contents’ ) && ! defined ( ‘FILE_APPEND’ ) ) <
.
>
?>

Also, if the file could not be accessed for writing, the function should return boolean false, not 0. An error is different from 0 bytes written, in this case.

I made ​​a ftp_put_contents function.

function ftp_put_contents ( $fpc_path_and_name , $fpc_content ) <

//Temporary folder in the server
$cfg_temp_folder = str_replace ( «//» , «/» , $_SERVER [ ‘DOCUMENT_ROOT’ ]. «/_temp/» );

//FTP username
$cfg_user = «user» ;

//FTP password
$cfg_pass = «password» ;

//Document Root of FTP
$cfg_document_root = «DOCUMENT ROOT OF FTP» ;

//Link to the website
$cfg_site_link = «Link to the website» ;

//Check if conteins slash on the path of the file
$cotains_slash = strstr ( $fpc_path_and_name , «/» );

//Get filename and paths
if ( $cotains_slash ) <
$fpc_path_and_name_array = explode ( «/» , $fpc_path_and_name );
$fpc_file_name = end ( $fpc_path_and_name_array );
>
else <
$fpc_file_name = $fpc_path_and_name ;
>

//Create local temp dir
if (! file_exists ( $cfg_temp_folder )) <
if (! mkdir ( $cfg_temp_folder , 0777 )) <
echo «Unable to generate a temporary folder on the local server — $cfg_temp_folder .<br />» ;
die();
>
>

//Create local file in temp dir
if (! file_put_contents ( str_replace ( «//» , «/» , $cfg_temp_folder . $fpc_file_name ), $fpc_content )) <
echo «Unable to generate the file in the temporary location — » . str_replace ( «//» , «/» , $cfg_temp_folder . $fpc_file_name ). «.<br />» ;
die();
>

//Connection to the FTP Server
$fpc_ftp_conn = ftp_connect ( » $cfg_ftp_server » );

//Check connection
if (! $fpc_ftp_conn ) <
echo «Could not connect to server <b> $cfg_ftp_server </b>.<br />» ;
die();
>
else <

// login
// check username and password
if (! ftp_login ( $fpc_ftp_conn , » $cfg_user » , » $cfg_pass » )) <
echo «User or password.<br />» ;
die();
>
else <

//Document Root
if (! ftp_chdir ( $fpc_ftp_conn , $cfg_document_root )) <
echo «Error to set Document Root.<br />» ;
die();
>

//Check if there are folders to create
if ( $cotains_slash ) <

//Check if have folders and is not just the file name
if ( count ( $fpc_path_and_name_array ) > 1 ) <

//Remove last array
$fpc_remove_last_array = array_pop ( $fpc_path_and_name_array );

//Checks if there slashs on the path
if ( substr ( $fpc_path_and_name , 0 , 1 ) == «/» ) <
$fpc_remove_first_array = array_shift ( $fpc_path_and_name_array );
>

//Create each folder on ftp
foreach ( $fpc_path_and_name_array as $fpc_ftp_path ) <
if (!@ ftp_chdir ( $fpc_ftp_conn , $fpc_ftp_path )) <
if (! ftp_mkdir ( $fpc_ftp_conn , $fpc_ftp_path )) <
echo «Error creating directory $fpc_ftp_path .<br />» ;
>
else <
if (! ftp_chdir ( $fpc_ftp_conn , $fpc_ftp_path )) <
echo «Error go to the directory $fpc_ftp_path .<br />» ;
>
>
>
>
>
else <

//Check upload file
if (! ftp_put ( $fpc_ftp_conn , $fpc_file_name , str_replace ( «//» , «/» , $cfg_temp_folder . $fpc_file_name ), FTP_ASCII )) <
echo «File upload <b> $fpc_path_and_name </b> failed!<br />» ;
die();
>
else <
if (! unlink ( str_replace ( «//» , «/» , $cfg_temp_folder . $fpc_file_name ))) <
echo «Error deleting temporary file.<br />» ;
die();
>
else <
echo «File upload <a href=’ $cfg_site_link » . str_replace ( «//» , «/» , «/ $fpc_path_and_name » ). «‘><b> $cfg_site_link » . str_replace ( «//» , «/» , «/ $fpc_path_and_name » ). «</a></b> successfully performed.<br />» ;
>
>

//Close connection to FTP server
ftp_close ( $fpc_ftp_conn );
>
>
>

file_put_contents

Функция идентична последовательным успешным вызовам функций fopen() , fwrite() и fclose() .

Если filename не существует, файл будет создан. Иначе, существующий файл будет перезаписан, за исключением случая, если указан флаг FILE_APPEND .

Список параметров

Путь к записываемому файлу.

Записываемые данные. Может быть string , array или ресурсом stream .

Если data является ресурсом stream , оставшийся буфер этого потока будет скопирован в указанный файл. Это похоже на использование функции stream_copy_to_stream() .

Также вы можете передать одномерный массив в качестве параметра data . Это будет эквивалентно вызову file_put_contents($filename, implode('', $array)).

Значением параметра flags может быть любая комбинация следующих флагов, соединенных бинарным оператором ИЛИ (|).

Доступные флаги

Флаг	Описание
FILE_USE_INCLUDE_PATH	Ищет filename в подключаемых директориях. Подробнее смотрите директиву include_path.
FILE_APPEND	Если файл filename уже существует, данные будут дописаны в конец файла вместо того, чтобы его перезаписать.
LOCK_EX	Получить эксклюзивную блокировку на файл на время записи.

Корректный ресурс контекста, созданный с помощью функции stream_context_create() .

Возвращаемые значения

Функция возвращает количество записанных байт в файл, или FALSE в случае ошибки.

Эта функция может возвращать как boolean FALSE , так и не-boolean значение, которое приводится к FALSE . За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

Примеры

Пример #1 Пример простого использования

Пример #2 Использование флагов

Список изменений

Версия	Описание
5.1.0	Добавлена поддержка LOCK_EX и возможность передачи потокового ресурса в параметр data

Примечания

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen wrappers. Смотрите более подробную информацию об определении имени файла в описании функции fopen() . Смотрите также список поддерживаемых оберток URL, их возможности, замечания по использованию и список предопределенных констант в Поддерживаемые протоколы и обработчики (wrappers).

Работа с файлами в PHP

С помощью функции file_get_contents() можно получить содержимое файла:

Также мы можем получить html-код какой-либо страницы в интернете:

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

Чтение файла: file()

Функция file() позволяет получить содержимое файла в виде массива. Разделителем элементов является символ переноса строки.

Создадим в корне сайта файл data.txt со следующим содержимым:

Теперь запустим скрипт index.php со следующим кодом:

При запуске этого скрипта мы получим в браузере:

Заметили, что у первых двух строк длина 7 символов вместо пяти? Это из-за того, что каждая строка содержит в конце символы переноса строки.

Чаще всего они нам не нужны, поэтому их можно убрать, передав вторым параметром константу FILE_IGNORE_NEW_LINES :

Теперь у всех строк будет по 5 символов.

Если нам необходимо получить только заполненные строки в файле и пропустить пустые, можно передать вторым параметром константу FILE_SKIP_EMPTY_LINES :

Разумеется, мы можем передать сразу две константы:

Создание файла и запись в файл: file_put_contents()

Функция file_put_contents() позволяет создать файл и заполнить его данными.

Первым параметром функция принимает путь к файлу, вторым — строку с данными. Для создания пустого файла нужно передать вторым параметром пустую строку.

Если файла не существует — он будет создан. Если существует — данные в файле будут перезаписаны.

Чтобы не перезаписывать данные, а добавить их в конец файла, нужно передать третьим параметром константу FILE_APPEND :

Также вторым параметром можно передать массив:

Но этот вариант не очень удобен, поскольку все элементы массива запишутся подряд, без каких-либо разделителей. Чтобы их добавить, можно использовать функцию implode:

Создание папки или структуры папок

Создать папку можно с помощью функции mkdir() (make directory):

Вторым параметром указываются права доступа к файлу в виде восьмеричного числа, по-умолчанию это 0777 , что означает самые широкие права. Для Windows этот аргумент игнорируется.

Кроме этого, второй параметр может игнорироваться при заданной umask (пользовательская маска (user mask), которая нужна для определения конечных прав доступа). В этом случае принудительно сменить права можно функцией chmod() :

Также мы можем создать структуру папок рекурсивно, для этого нужно третьим параметром передать true :

Но в этом случае права доступа будут заданы только для конечной папки. Для изменения прав у каждой из папок придётся указывать права вручную:

Права доступа — это отдельная объёмная тема, поэтому сейчас мы её пока рассматривать не будем.

Проверка существования файла или папки

Проверить существование папки или файла можно с помощью функции file_exists() :

Если вы хотите проверить существование только папки или только файла, для этого есть специальные функции is_dir() и is_file() :

Проверка прав доступа

Функции is_readable() и is_writable() проверяют, есть ли у пользователя, от имени которого запущен PHP, права на чтение и запись файла или папки:

Копирование, перенос и удаление файла

Для удаления файлов используется функция unlink() :

Чтобы скопировать файл, используем функцию copy() :

Для переименования и переноса файла в другую папку используется функция rename() :

Работа с файлами с помощью fopen()

Функций file() , file_get_contents() и file_put_contents() достаточно для решения большинства задач, связанных с управлением файлами.

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

Итак, открыть (или создать и открыть) файл можно с помощью функции fopen() :

Функция fopen() возвращает так называемый лескриптор. Это ссылка, указатель на файл, его мы будем передавать в другие функции. Кстати, тип данных этого дескриптора — resource .

Первым параметром мы передаём путь к файлу, вторым — модификатор доступа к файлу. Ниже перечислены наиболее популярные модификаторы:

• r — открытие для чтения, указатель переходит в начало файла.
• r+ — открытие для чтения и записи, указатель переходит в начало файла.
• w — открытие для записи, указатель переходит в начало файла. Если файла нет — создаётся, если есть — очищается от данных.
• w+ — открытие для чтения и записи, в остальном аналогичен w .
• a — открытие для записи, указатель переходит в конец файла. Если файла нет — создаётся.
• a+ — открытие для чтения и записи, в остальном аналогичен a .
• x — создание и открытие для записи, указатель переходит в начало файла. Если файл существует — PHP покажет ошибку.
• x+ — создание и открытие для чтения и записи, в остальном аналогичен x .

Указатель — это нечто вроде курсора. Вы можете переместить его в любое место файла, чтобы добавить или отредактировать определённые данные.

Для записи данных в файл существует функция fwrite() . Давайте попробуем создать файл и записать в него какие-нибудь данные:

Заметьте, из-за модификатора w при каждом запуске скрипта данные в файле стираются и добавляются заново. Если модификатор заменить на a , данные будут не перезаписываться, а добавляться в конец файла.

Для построчного чтения файла используется функция fgets() :

При каждом запуске fgets получает следующую строку и возвращает её в $line . Вторым параметром передаётся максимальная длина строки. Это означает, что если строка слишком длинная, она будет обрезана.

Также в PHP существует множество других полезных функций, работающих с дескриптором файла. Почитать о них можно в документации.

Запись и чтение файлов в PHP

Примеры сохранения и чтения текстовых данных и массивов в файлы.

Сохранение в файл

Функция file_put_contents() записывает содержимое переменной в файл, если файла не существует. то пытается его создать, если существует то полностью перезапишет его.

File_put_contents:

Fopen / fwrite:

Набор функций fopen, fwrite, fclose предназначены для более гибкой работы с файлами.

• fopen – открытие или создание файла.
• fwrite – запись данных.
• fclose – закрытие файла.

Возможные режимы fopen():

Mode	Описание
r	Открывает файл только для чтения, помещает указатель в начало файла.
r+	Открывает файл для чтения и записи, помещает указатель в начало файла.
w	Открывает файл только для записи, помещает указатель в начало файла и обрезает файл до нулевой длины. Если файл не существует – пробует его создать.
w+	Открывает файл для чтения и записи, помещает указатель в начало файла и обрезает файл до нулевой длины. Если файл не существует – пытается его создать.
a	Открывает файл только для записи, помещает указатель в конец файла. Если файл не существует – пытается его создать.
a+	Открывает файл для чтения и записи, помещает указатель в конец файла. Если файл не существует – пытается его создать.
x	Создаёт и открывает только для записи; помещает указатель в начало файла. Если файл уже существует, вызов fopen() закончится неудачей, вернёт false и выдаст ошибку. Если файл не существует, попытается его создать.
x+	Создаёт и открывает для чтения и записи, в остальном имеет то же поведение, что и « x ».
c	Открывает файл только для записи. Если файл не существует, то он создаётся. Если же файл существует, то он не обрезается (в отличие от « w »), и вызов к этой функции не вызывает ошибку (также как и в случае с « x »). Указатель на файл будет установлен на начало файла.
c+	Открывает файл для чтения и записи, в остальном имеет то же поведение, что и « c ».

Доступно в место fwrite() используют fputs() , разницы ни какой т.к. эта функция является псевдонимом.