Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sync filesystem functions without EN-Revision #9

Merged
merged 1 commit into from
Jun 22, 2024
Merged

Sync filesystem functions without EN-Revision #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
204 changes: 132 additions & 72 deletions reference/filesystem/functions/file.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,117 +1,177 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: adi Status: ready -->
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2957432ebc5ba2770805c08d5c867543ced8dd85 Maintainer: grzesiek Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.file" xmlns="http://docbook.org/ns/docbook">
<!-- CREDITS: sobak, adi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file">
<refnamediv>
<refname>file</refname>
<refpurpose>Czyta całą zawartość pliku do tablicy</refpurpose>
<refpurpose>Wczytuje cały plik do tablicy</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>file</methodname>
<methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flagi</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>kontekst</parameter></methodparam>
<type class="union"><type>array</type><type>false</type></type><methodname>file</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Działa podobnie do <function>file_get_contents</function>, tylko że
<function>file</function> zwraca plik w tablicy. Każdy
element tablicy odpowiada linii w pliku. Elementy tablicy zawierają
znak nowej linii. W przypadku błędu, <function>file</function>
zwraca &false;.
Wczytuje cały plik do tablicy.
</para>
<note>
<para>
Możesz użyć funkcji <function>file_get_contents</function>, aby zwrócić zawartość
pliku jako ciąg znaków.
</para>
</note>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
Opcjonalny parametr <parameter>flagi</parameter> może być jedną lub więcej, z
następujących stałych:
<variablelist>
<varlistentry>
<term>
<constant>FILE_USE_INCLUDE_PATH</constant>
</term>
<term><parameter>filename</parameter></term>
<listitem>
<simpara>
Poszukuj pliku w <link linkend="ini.include-path">include_path</link>.
</simpara>
<para>
Ścieżka do pliku.
</para>
&tip.fopen-wrapper;
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_IGNORE_NEW_LINES</constant>
</term>
<term><parameter>flags</parameter></term>
<listitem>
<simpara>
Nie dodawaj nowej lini na na końcu każdego elementu tablicy.
</simpara>
<para>
Opcjonalny parametr <parameter>flags</parameter> może być jedną lub
kilkoma z następujących stałych:
<variablelist>
<varlistentry>
<term>
<constant>FILE_USE_INCLUDE_PATH</constant>
</term>
<listitem>
<simpara>
Wyszukuje plik w <link
linkend="ini.include-path">include_path</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_IGNORE_NEW_LINES</constant>
</term>
<listitem>
<simpara>
Pomija znak nowej linii na końcu każdego elementu tablicy
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_SKIP_EMPTY_LINES</constant>
</term>
<listitem>
<simpara>
Pomija puste linie
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_NO_DEFAULT_CONTEXT</constant>
</term>
<listitem>
<simpara>
Nie używa domyślnego kontekstu
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>FILE_SKIP_EMPTY_LINES</constant>
</term>
<term><parameter>context</parameter></term>
<listitem>
<simpara>
Pomiń puste linie.
</simpara>
&note.context-support;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca plik w postaci tablicy. Każdy element tablicy odpowiada
linii w pliku, z dołączoną nową linią. W przypadku niepowodzenia
<function>file</function> zwraca &false;.
</para>
<note>
<para>
Przed PHP 5.0.0 parametr <parameter>flagi</parameter> jedynie
ukrywał <link linkend="ini.include-path">include_path</link> i był
włączany przez 1.
Każda linia w wynikowej tablicy będzie zawierała zakończenie linii,
chyba że zostanie użyta stała <constant>FILE_IGNORE_NEW_LINES</constant>.
</para>
</note>
&note.line-endings;
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Emituje błąd poziomu <constant>E_WARNING</constant>, jeśli plik nie
istnieje.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<informalexample>
<example>
<title>Przykład <function>file</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Pobierz plik do tablicy. W tym przykładzie poprzez HTTP pobierzemy
// źródło HTML z URL
// Pobieranie pliku do tablicy. W tym przykładzie przejdziemy przez HTTP, aby uzyskać
// źródło HTML adresu URL.
$lines = file('http://www.example.com/');
// Za pomocą pętli przeglądamy naszą tablicę i pokazujemy źródło strony w postaci
// źródła HTML oraz numery linii.
foreach ($lines as $line_num => $line) {
echo "Linia #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";

// Pętla przez naszą tablicę, wyświetla źródło HTML jako źródło HTML; a także numery linii.
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}

// Kolejny przyklad pozwala pobrać stronę i umieścić ją w łańcuchu znaków Zobacz także file_get_contents().
$html = implode ('', file ('http://www.example.com/'));
// Używanie opcjonalnego parametru flags
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>
]]>
</programlisting>
</informalexample>
</example>
</para>
&tip.fopen-wrapper;
<note>
<para>
Każda linia w wynikowej tabeli będzie zawierać znak(i) końca linii chyba, że jest użyte FILE_IGNORE_NEW_LINES,
jeśli nie chcesz ich musisz uzyć <function>rtrim</function>.
</para>
</note>
&note.line-endings;
<note>
<para>
W PHP 4.3.0 możesz użyć <function>file_get_contents</function> aby
zwrócić zawartość pliku do łańcucha.
</para>
<para>
W PHP 4.3.0 <function>file</function> stał się binarnie bezpieczny.
</para>
</note>
&note.context-support;
&warn.ssl-non-standard;
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
&warn.ssl-non-standard;
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Patrz także: <function>readfile</function>,
<function>fopen</function>, <function>fsockopen</function>,
<function>popen</function>, <function>file_get_contents</function>,
<function>include</function> i
<function>stream_context_create</function>.
<simplelist>
<member><function>file_get_contents</function></member>
<member><function>readfile</function></member>
<member><function>fopen</function></member>
<member><function>fsockopen</function></member>
<member><function>popen</function></member>
<member><function>include</function></member>
<member><function>stream_context_create</function></member>
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
115 changes: 83 additions & 32 deletions reference/filesystem/functions/filectime.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,58 +1,109 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: adi Status: ready -->
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: grzesiek Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.filectime" xmlns="http://docbook.org/ns/docbook">
<!-- CREDITS: sobak, adi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filectime">
<refnamediv>
<refname>filectime</refname>
<refpurpose>Pobiera i-węzłowy czas zmiany pliku</refpurpose>
<refpurpose>Pobiera czas zmiany inode pliku</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>filectime</methodname>
<methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
<type class="union"><type>int</type><type>false</type></type><methodname>filectime</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Zwraca czas, ostatniej zmiany pliku lub &false; w
przypadku błędu. Czas jest zwracany w postaci unix'owego znacznika
czasu.
Pobiera czas zmiany inode pliku.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
Uwaga: W większości Unixowych systemów plików, plik ulega zmianie
wtedy kiedy dane jego i-węzła zmieniają się; tj. kiedy prawa dostępu,
właściciel, grupa lub inne metadane z i-węzłą są nadpisywane.
Patrz także: <function>filemtime</function> (którą powinnieneś użyć, gdy chcesz stworzyć
stopkę strony "Ostatnia Modyfikacja") i
<function>fileatime</function>.
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Scieżka do pliku.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>Zauważ także, że w niektórych tekstach Unixowych ctime pliku jest
określany jako będący czasem stworzenia pliku. To jest nieprawidłowe.
Nie ma pojęcia czasu stworzenia dla plików Unixowych większości Unixowych systemów plików.
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca czas ostatniej zmiany pliku &return.falseforfailure;.
Czas jest zwracany jako uniksowy znacznik czasu.
</para>
&note.clearstatcache;
&tip.fopen-wrapper.stat;
<para>
<example>
<title><function>filectime</function> przykład</title>
<programlisting role="php">
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Przykład <function>filectime</function></title>
<programlisting role="php">
<![CDATA[
<?php

// wyświetli np. jakisplik.txt został ostatnio zmieniony : December 29 2002 22:16:23.
// zwróci n.p. został ostatnio zmieniony: December 29 2002 22:16:23.

$filename = 'jakisplik.txt';
$filename = 'somefile.txt';
if (file_exists($filename)) {
echo "$filename został ostatnio zmieniony : " . date("F d Y H:i:s.", filectime($filename));
echo "$filename was last changed: " . date("F d Y H:i:s.", filectime($filename));
}

?>
]]>
</programlisting>
</example>
</para>
<simpara>
Patrz także: <function>filemtime</function>
</simpara>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Uwaga: W większości uniksowych systemów plików plik jest uważany za zmieniony,
gdy zmienią się dane jego i-węzła; to znaczy, gdy uprawnienia, właściciel, grupa lub
inne metadane z i-węzła zostaną zaktualizowane. Zobacz także
<function>filemtime</function> (to jest to, czego chcesz użyć, gdy chcesz
utworzyć stopki "Last Modified" na stronach internetowych) i
<function>fileatime</function>.
</para>
</note>
<note>
<para>
Należy również zauważyć, że w niektórych tekstach uniksowych ctime pliku jest
określany jako czas utworzenia pliku. Jest to błędne. W większości uniksowych
systemów plików nie ma czasu utworzenia pliku.
</para>
</note>
&note.filesystem-time-res;
&note.clearstatcache;
&tip.fopen-wrapper.stat;
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>filemtime</function></member>
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
Loading