fopen Открывает файл или URL &reftitle.description; resourcefalsefopen stringfilename stringmode booluse_include_path&false; resourcenullcontext&null; fopen закрепляет именованный ресурс, указанный в аргументе filename, за потоком. &reftitle.parameters; filename Если filename передан в форме "scheme://...", он считается URL и PHP проведёт поиск обработчика протокола (также известного как "обёртка") для этой схемы. Если ни одна обёртка не закреплена за протоколом, PHP выдаст замечание, чтобы помочь вам отследить потенциальную проблему в вашем скрипте и затем продолжит выполнение, как если бы filename указывал на обыкновенный файл. Если PHP установлено, что filename указывает на локальный файл, тогда выполняется попытка открыть поток к этому файлу. Файл должен быть доступен PHP, так что вам следует убедиться, что права доступа на файл это разрешают. Если вы включили open_basedir, то накладываются дальнейшие ограничения. Если PHP установил, что filename указывает на зарегистрированный протокол и этот протокол зарегистрирован как сетевой URL, PHP выполняет проверку состояния директивы allow_url_fopen. Если она выключена, PHP выдаст предупреждение и вызов fopen закончится неудачей. Список поддерживаемых протоколов доступен в разделе . Некоторые протоколы (обёртки) поддерживают контекст и/или опции &php.ini;. Обратитесь к соответствующей странице с описанием используемого протокола для получения списка опций, которые могут быть установлены. (например, значение &php.ini; user_agent используется обёрткой http). На платформе Windows, необходимо экранировать все обратные слеши в пути к файлу или использовать прямые слеши. ]]> mode Параметр mode указывает тип доступа, который вы запрашиваете у потока. Он может быть одним из следующих вариантов: mode Описание 'r' Открывает файл только для чтения; помещает указатель в начало файла. 'r+' Открывает файл для чтения и записи; помещает указатель в начало файла. 'w' Открывает файл только для записи; в противном случае ведёт себя так же, как и 'w+'. 'w+' Открывает файл для чтения и записи; помещает указатель в начало файла и обрезает файл до нулевой длины. Если файл не существует - пытается его создать. 'a' Открывает файл только для записи; помещает указатель в конец файла. Если файл не существует - пытается его создать. В данном режиме функция fseek не применима, записи всегда добавляются в конец. 'a+' Открывает файл для чтения и записи; помещает указатель в конец файла. Если файл не существует - пытается его создать. В данном режиме функция fseek влияет только на позицию чтения, записи всегда добавляются в конец. 'x' Создаёт и открывает только для записи; помещает указатель в начало файла. Если файл уже существует, вызов fopen закончится неудачей, вернёт &false; и выдаст ошибку уровня E_WARNING. Если файл не существует, попытается его создать. Это эквивалентно указанию флагов O_EXCL|O_CREAT для внутреннего системного вызова open(2). 'x+' Создаёт и открывает для чтения и записи; в остальном имеет то же поведение, что и'x'. 'c' Открывает файл только для записи. Если файл не существует, то он создаётся. Если же файл существует, то он не обрезается (в отличие от 'w'), и вызов к этой функции не вызывает ошибку (также как и в случае с 'x'). Указатель на файл будет установлен на начало файла. Это может быть полезно при желании заблокировать файл (смотрите flock) перед изменением, так как использование 'w' может обрезать файл ещё до того как была получена блокировка (если вы желаете обрезать файл, можно использовать функцию ftruncate после запроса на блокировку). 'c+' Открывает файл для чтения и записи; в остальном имеет то же поведение, что и 'c'. 'e' Установить флаг close-on-exec (закрыть при запуске) на открытый файловый дескриптор. Доступно только в PHP скомпилированном на системах поддерживающих POSIX.1-2008. Разные семейства операционных систем имеют разные соглашения относительно окончания строк. Когда вы пишете текст и хотите вставить разрыв строки, вы должны использовать правильные символы (или символ) для вашей операционной системы. Системы семейства Unix используют \n в качестве символа конца строки, системы семейства Windows используют \r\n в качестве символов окончания строки и системы семейства Macintosh (Mac OS Classic) используют \r в качестве символа конца строки. Если вы используете неверный символ конца строки при редактировании файлов, вы можете обнаружить, что при открытии эти файлы "странно выглядят". Windows предлагает флаг режима текстовой трансляции ('t'), который автоматически переведёт \n в \r\n во время работы с файлом. И наоборот - вы также можете использовать 'b', чтобы принудительно включить бинарный режим, в котором ваши данные не будут преобразовываться. Чтобы использовать эти режимы, укажите 'b' или 't' последней буквой параметра mode. Флагом трансляции по умолчанию является 'b'. Вы можете использовать режим 't', если работаете с текстовыми файлами и используете \n для обозначения конца строки в вашем скрипте, но при этом предполагаете, что ваши файлы будут использоваться в таких приложениях, как "Блокнот" (в устаревших версиях). Во всех остальных случаях используйте флаг 'b'. Если вы укажете флаг 't' во время работы с бинарными файлами, вы можете столкнуться со странными проблемами с вашими данными, включая повреждённые файлы изображений и проблемы с символами \r\n. Опять же из соображений портируемости крайне рекомендуется переписать старый код, который полагается на режим 't', чтобы вместо этого он использовал правильные концы строк и режим 'b'. Параметр mode игнорируется при работе с обёртками потока php://output, php://input, php://stdin, php://stdout, php://stderr и php://fd. use_include_path Необязательный третий параметр use_include_path может быть установлен в '1' или &true;, если вы также хотите провести поиск файла в include_path. context ¬e.context-support; &reftitle.returnvalues; Возвращает указатель на файл в случае успешного выполнения&return.falseforfailure; &reftitle.errors; &fs.emits.warning.on.failure; &reftitle.changelog; &Version; &Description; 7.0.16, 7.1.2 Добавлена опция 'e'. &reftitle.examples; ]]> &reftitle.notes; &warn.ssl-non-standard; Если вы сталкиваетесь с проблемами во время чтения или записи файлов, и вы используете PHP в виде серверного модуля, убедитесь в том, что процесс сервера имеет доступ к используемым вами файлам и директориям. Данная функция также может принимать директории в качестве параметра filename. Если вы не знаете, является ли filename файлом или директорией, то вам может понадобиться использовать функцию is_dir до вызова функции fopen. &reftitle.seealso; fclose fgets fread fwrite fsockopen file file_exists is_readable stream_set_timeout popen stream_context_create umask SplFileObject