svn: /phpdoc/kr/trunk/ language-defs.ent language-snippets.ent
[email protected] (LEE Yun-young)
| Newsgroups | php.doc.kr |
|---|---|
| Message-ID | <[email protected]> |
progcom Fri, 06 Feb 2015 12:33:04 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=335891
Log:
update for recent language entities
Changed paths:
U phpdoc/kr/trunk/language-defs.ent
U phpdoc/kr/trunk/language-snippets.ent
svn-diffs-335891.txt
(text/x-diff, 56.9 KB)
Modified: phpdoc/kr/trunk/language-defs.ent
===================================================================
--- phpdoc/kr/trunk/language-defs.ent 2015-02-06 11:53:37 UTC (rev 335890)
+++ phpdoc/kr/trunk/language-defs.ent 2015-02-06 12:33:04 UTC (rev 335891)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 298760 Maintainer: progcom Status: ready -->
+<!-- EN-Revision: 331319 Maintainer: progcom Status: ready -->
<!-- Part title used mostly in manual.xml itself -->
<!ENTITY PHPManual "PHP 매뉴얼">
@@ -41,13 +41,21 @@
<!ENTITY ServerSpecificExtentions "특정 서버 확장">
<!ENTITY SearchEngineExtentions "검색 엔진 확장">
<!ENTITY MiscExtentions "기타 확장">
+<!ENTITY Appendices "부록">
<!ENTITY PEAR "PEAR: PHP 확장 및 어플리케이션 저장소">
<!ENTITY FAQ "FAQ: 자주 물어보는 질문들">
<!ENTITY FAQabbrev "FAQ">
<!ENTITY Internals "PHP와 Zend 엔진 내부">
<!ENTITY Internals2 "PHP 코어: Zend 엔진 해커 가이드">
<!ENTITY ZendAPI "Zend API: PHP 코어 해킹">
-<!ENTITY FunctionIndex "함수 인덱스">
+<!ENTITY IndexListing "인덱스 목록">
+<!ENTITY FunctionListing "함수와 메소드 목록">
+<!ENTITY FunctionListingDescription "매뉴얼의 모든 함수와 메소드 목록">
+<!ENTITY ExampleListing "예제 목록">
+<!ENTITY ExampleListingDescription "매뉴얼의 모든 예제 목록">
+<!ENTITY ChangelogListingTitle "변경점">
+<!ENTITY ChangelogListingDescription "이 확장의 클래스/함수/메소드에 다음과 같은 변경이 이루어졌습니다.">
+<!ENTITY ChangelogListingBundledDescription "번들 확장 함수에 다음과 같은 변경이 이루어졌습니다.">
<!ENTITY CHMEdition "HTML 도움말 에디션">
<!ENTITY ReservedConstants "예약 상수">
<!ENTITY MissingStuff "빠진 내용">
@@ -68,10 +76,10 @@
<!ENTITY InheritedProperties "상속된 프로퍼티">
<!ENTITY Properties "프로퍼티">
<!ENTITY Constants "상수">
+<!ENTITY NotAvailable "사용할 수 없음">
<!-- These are using in reference/$extname/reference.xml and other
supplemental files to mark section titles -->
-<!ENTITY reftitle.changelog '<title xmlns="http://docbook.org/ns/docbook">&Changelog;</title>'>
<!ENTITY reftitle.classes '<title xmlns="http://docbook.org/ns/docbook">예약 클래스</title>'>
<!ENTITY reftitle.classsynopsis '<title xmlns="http://docbook.org/ns/docbook">클래스 개요</title>'>
<!ENTITY reftitle.constants '<title xmlns="http://docbook.org/ns/docbook">예약 상수</title>'>
@@ -80,8 +88,7 @@
<!ENTITY reftitle.encoding '<title xmlns="http://docbook.org/ns/docbook">인코딩</title>'>
<!ENTITY reftitle.examples '<title xmlns="http://docbook.org/ns/docbook">예제</title>'>
<!ENTITY reftitle.exceptions '<title xmlns="http://docbook.org/ns/docbook">예외</title>'>
-<!ENTITY reftitle.errors '<title xmlns="http://docbook.org/ns/docbook">오류/예외</title>'>
-<!ENTITY reftitle.faq '<title xmlns="http://docbook.org/ns/docbook">&FAQ;</title>'>
+<!ENTITY reftitle.errors '<title xmlns="http://docbook.org/ns/docbook">오류/예외</title>'><!ENTITY reftitle.faq '<title xmlns="http://docbook.org/ns/docbook">&FAQ;</title>'>
<!ENTITY reftitle.install '<title xmlns="http://docbook.org/ns/docbook">설치</title>'>
<!ENTITY reftitle.intro '<title xmlns="http://docbook.org/ns/docbook">소개</title>'>
<!ENTITY reftitle.indices '<title xmlns="http://docbook.org/ns/docbook">인덱스</title>'>
@@ -98,4 +105,4 @@
<!ENTITY reftitle.seealso '<title xmlns="http://docbook.org/ns/docbook">참고</title>'>
<!ENTITY reftitle.setup '<title xmlns="http://docbook.org/ns/docbook">설치/설정</title>'>
<!ENTITY reftitle.unicode '<title xmlns="http://docbook.org/ns/docbook">유니코드</title>'>
-
+<!ENTITY reftitle.usage '<title xmlns="http://docbook.org/ns/docbook">사용법</title>'>
Modified: phpdoc/kr/trunk/language-snippets.ent
===================================================================
--- phpdoc/kr/trunk/language-snippets.ent 2015-02-06 11:53:37 UTC (rev 335890)
+++ phpdoc/kr/trunk/language-snippets.ent 2015-02-06 12:33:04 UTC (rev 335891)
@@ -1,9 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 333393 Maintainer: progcom Status: ready -->
+<!-- EN-Revision: 335744 Maintainer: progcom Status: ready -->
<!-- Keep 'em sorted -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>난수 생성기는 자동으로 초기화됩니다.</entry></row>'>
+
<!ENTITY installation.enabled.disable '이 확장은 기본값으로 활성화됩니다. 컴파일 시에 다음 옵션으로 비활성화 할 수 있습니다: '>
<!-- Cautions -->
@@ -16,6 +17,7 @@
합니다. 이 함수를 호출하면 <constant>E_DEPRECATED</constant> 주의가
발생합니다. PCRE로 변환하는 데 필요한 도움은 <link linkend="reference.pcre.pattern.posix">차이점 목록</link>을 참고하십시오.</para></note>'>
+
<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 바이너리
안전입니다.</simpara></note>'>
@@ -35,8 +37,11 @@
<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>함수 이름 대신에, 객체의 참조와
메쏘드 이름을 가지는 배열을 사용할 수 있습니다.</simpara></note>'>
+
<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para><function>call_user_func</function>와 <function>call_user_func_array</function> 등으로 등록한 콜백은 이전 콜백 실행시에 처리하지 않은 예외(uncaught exception)가 존재할 경우 호출되지 않습니다.</para></note>'>
+
+
<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>인수가 참조로 전달되면,
인수에 대한 변화는 이 함수가 반환하는 값에 영향을 줍니다.</para></note>'>
@@ -44,11 +49,13 @@
의존하기 때문에, 함수의 인수로 사용할 수 없습니다. 이 값을 함수에 넘겨야
한다면, 결과값을 변수에 할당하여 그 변수로 넘겨야 합니다.</para></note>'>
+
<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>PHP가 매킨토시 컴퓨터에서 파일을
읽거나 작성할 때 행의 끝을 판단하지 못하면, <link
linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link> 실행
옵션을 활성화 함으로써 문제가 해결될 수 있습니다.</simpara></note>'>
+
<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는
<link linkend="features.remote-files">원격 파일</link>을 다루지 못합니다.
파일은 서버 파일시스템을 통해서 사용 가능해야만 합니다.</simpara></note>'>
@@ -72,8 +79,7 @@
난수값 생성기 초기화를 할 필요가 없습니다. 자동적으로 이루어집니다.
</simpara></note>'>
-<!ENTITY note.registerglobals '<note xmlns="http://docbook.org/ns/docbook"><title>register_globals: 중요
-경고</title><para>PHP 4.2.0부터 PHP 지시어 <link
+<!ENTITY note.registerglobals '<note xmlns="http://docbook.org/ns/docbook"><title>register_globals: 중요 경고</title><para>PHP 4.2.0부터 PHP 지시어 <link
linkend="ini.register-globals">register_globals</link>의 기본값은
<emphasis>off</emphasis>입니다. PHP
커뮤니티에서는 이 지시어에 의존하지 않는 &link.superglobals; 방식의 사용을
@@ -84,6 +90,7 @@
위해서 <command>global $variable;</command>를 할 필요가
없습니다.</para></note>">
+
<!ENTITY note.superglobals '<note xmlns="http://docbook.org/ns/docbook"><title>자동 전역: 사용상
주의</title><para><varname>$_GET</varname>, <varname>$_POST</varname>,
<varname>$_SERVER</varname> 등의 자동 전역 배열은 PHP 4.1.0부터 사용할 수
@@ -97,7 +104,9 @@
<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>시간 정밀도는 각각 파일
시스템에 따라 다를 수 있습니다.</para></note>'>
-<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook"><para>이 함수를 사용할 때 클래스를 찾을 수 없으면, 등록된 <link linkend="language.oop5.autoload">오토로더</link>를 사용합니다.</para></note>'>
+<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook"><para>이 함수를 사용할 때
+클래스를 찾을 수 없으면,
+등록된 <link linkend="language.oop5.autoload">오토로더</link>를 사용합니다.</para></note>'>
<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
<para>
@@ -106,6 +115,7 @@
</note>
'>
+
<!ENTITY note.passwordhashing '<note xmlns="http://docbook.org/ns/docbook">
<title>안전한 패스워드 해싱</title>
<para>
@@ -123,6 +133,9 @@
다양한 래퍼의 기능, 사용법, 제공하는 예약 정의 변수들에 대해서는
<xref linkend="wrappers"/>를 참고하십시오.</simpara></tip>'>
+
+
+
<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>PHP 5.0.0부터 이 함수는
<emphasis>몇몇</emphasis> URL 래퍼를 사용할 수 있습니다. 기능적으로
<function>stat</function> 패밀리를 지원하는 래퍼 목록은 <xref
@@ -133,9 +146,11 @@
이용해서 이 함수의 출력을 캡쳐하여, (예를 들면) <type>string</type>으로
저장할 수 있습니다.</simpara></tip>'>
+
<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara>참고: <xref linkend="userlandnaming" />.</simpara></tip>'>
+
<!-- Warnings -->
<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>사용자가 입력한 데이터를 이 함수로
@@ -153,6 +168,7 @@
<emphasis>배제</emphasis>되었습니다. 이 기능에 의존하지 않기를
권합니다.</simpara></warning>'>
+
<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>이 기능은 PHP 5.3.0부터
<emphasis>배제됩니다</emphasis>.
@@ -167,6 +183,7 @@
xmlns="http://docbook.org/ns/docbook"><simpara>이 기능은 PHP 5.3.0부터
<emphasis>배제되어</emphasis>, PHP 5.4.0부터 <emphasis>제거됩니다</emphasis>.</simpara></warning>'>
+
<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 PHP 5.3.0부터
<emphasis>배제되어</emphasis>, PHP 5.4.0부터 <emphasis>제거됩니다</emphasis>.</simpara></warning>'>
@@ -175,20 +192,25 @@
xmlns="http://docbook.org/ns/docbook"><simpara>이 기능은 PHP 5.5.0부터
<emphasis>배제됩니다</emphasis>. 이 기능에 의존하지 마십시오.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.feature-5-6-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>이 기능은 PHP 5.6.0부터
+<emphasis>배제됩니다</emphasis>. 이 기능에 의존하지 마십시오.
+</simpara></warning>'>
+
<!ENTITY removed.php.future '이 배제된 기능은 추후 <emphasis xmlns="http://docbook.org/ns/docbook">제거</emphasis>될 <emphasis xmlns="http://docbook.org/ns/docbook">예정</emphasis>입니다.'>
+
<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 PHP 5.3.0부터
-<emphasis>배제되어</emphasis>
-<emphasis>제거됩니다</emphasis>.</simpara></warning>'>
+<emphasis>배제되어</emphasis> <emphasis>제거됩니다</emphasis>.</simpara></warning>'>
<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 PHP 5.5.0부터
<emphasis>배제되어</emphasis> <emphasis>제거됩니다</emphasis>.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-5-3-0 '<warning
-xmlns="http://docbook.org/ns/docbook"><simpara>이 별칭은 PHP 5.3.0부터
-<emphasis>배제</emphasis>되었습니다. 이 기능에 의존하지 않기를
+xmlns="http://docbook.org/ns/docbook"><simpara>이 별칭은 PHP 5.3.0부터 <emphasis>배제</emphasis>되었습니다. 이 기능에 의존하지 않기를
권합니다.</simpara></warning>'>
<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
@@ -219,6 +241,7 @@
공격에 노출됩니다. 그러한 공격을 막기 위해 <link linkend="security.cgi-bin">CGI
보안 섹션</link>을 읽어보십시오.</para></warning>'>
+
<!ENTITY note.magicquotes.gpc '<note xmlns="http://docbook.org/ns/docbook"><title>지시어 주의:
magic_quotes_gpc</title><para>지시어 <link
linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>의 기본값은
@@ -228,9 +251,8 @@
<!ENTITY warn.no-win32-fopen-wrapper '<warning xmlns="http://docbook.org/ns/docbook"><para>PHP 4.3.0 이전의
윈도우 버전 PHP에서는 이 함수를 이용하여 원격 파일에
-접근할 수 없습니다. <link linkend="ini.allow-url-fopen">allow_url_fopen</link>을
-활성화하여도 마찬가지입니다.
-</para></warning>'>
+접근할 수 없습니다. <link linkend="ini.allow-url-fopen">allow_url_fopen</link>을 활성화하여도
+마찬가지입니다.</para></warning>'>
<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>SSL을 사용할 때, 마이크로소프트
IIS는 <literal>close_notify</literal> 식별자를 보내지 않은채 접속을 종료하는
@@ -243,8 +265,10 @@
<function>fsockopen</function>을 사용한다면, 경고를 직접 검출하여 없애야
합니다.</para></warning>'>
+
<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 현재
-문서화 되어있지 않습니다; 인수 목록만을 제공합니다.</simpara></warning>'>
+문서화 되어있지 않습니다; 인수 목록만을 제공합니다.
+</simpara></warning>'>
<!-- Misc -->
@@ -265,11 +289,16 @@
<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">PHP 5.4에서 위 예제의 출력:</para>'>
+<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">PHP 5.4에서 위 예제의 출력:</para>'>
+
+<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">PHP 5.4에서 위 예제의 출력:</para>'>
+
<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">32비트 머신에서 위 예제의 출력:</para>'>
<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">64비트 머신에서 위 예제의 출력:</para>'>
-<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">위 예제의 출력 예시:</para>'>
+<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">위 예제의 출력
+예시:</para>'>
<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">위 예제들의 출력:</para>'>
@@ -283,21 +312,22 @@
<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 사용 후에
입력 배열의 <type>array</type> 포인터를 <function>reset</function>합니다.</simpara></note>'>
-<!ENTITY seelalso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">배열 정렬 함수
-비교</link>'>
-<!ENTITY seealso.callback '<link xmlns="http://docbook.org/ns/docbook"
-linkend="language.types.callback">callback</link>형에 대한 정보'>
+<!ENTITY seelalso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">배열 정렬 함수 비교</link>'>
+<!ENTITY seealso.callback '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.callback">callback</link>형에 대한 정보'>
+
<!ENTITY avail.register-long-arrays 'PHP 5.0.0부터, 긴 형태의 PHP <link xmlns="http://docbook.org/ns/docbook"
linkend="language.variables.predefined">예약 변수</link> 배열을 <link xmlns="http://docbook.org/ns/docbook"
linkend="ini.register-long-arrays">register_long_arrays</link> 지시어로
제거할 수 있습니다.'>
+
<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook"><type>integer</type> 형이 사용될 때,
바이트로 값을 측정합니다. <link linkend="faq.using.shorthandbytes">FAQ</link>에
나와 있는 단축어를 사용할 수도 있습니다.</simpara>'>
+
<!ENTITY info.deprecated.alias '하위 호환을 위하여, 다음의 권장하지 않는
별칭을 사용할 수 있습니다: '>
@@ -309,14 +339,14 @@
하위 호환을 위하여 남겨져 있습니다. 앞으로 PHP에서 제거될 수 있으므로
사용하지 않기를 권합니다.</simpara>'>
-<!ENTITY ext.window.path.dll '이 확장이 동작하려면, <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>
-파일이 윈도우 시스템 <literal xmlns="http://docbook.org/ns/docbook">PATH</literal>에 존재하여야 합니다. 이를 위한
+<!ENTITY ext.windows.path.dll '이 확장이 동작하려면, <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>
+파일이 윈도우 시스템 <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>에 존재하여야 합니다. 이를 위한
정보는,
"<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">윈도우에서 PHP 디렉토리를 PATH에
추가하기</link>"에 관한 <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym>을 참고하십시오. DLL 파일을 PHP
폴더에서 윈도우 시스템 디렉토리로 복사하여도 작동하지만(시스템 디렉토리는
-기본적으로 시스템 <literal xmlns="http://docbook.org/ns/docbook">PATH</literal>에 존재하기 때문), 권장하지 않습니다.
-<emphasis>이 확장은 다음 파일이 <literal xmlns="http://docbook.org/ns/docbook">PATH</literal> 상에 존재하여야
+기본적으로 시스템 <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>에 존재하기 때문), 권장하지 않습니다.
+<emphasis>이 확장은 다음 파일이 <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> 상에 존재하여야
합니다:</emphasis> '>
<!ENTITY manual.migration.seealso 'PHP 버전에 맞는 이행 가이드를
@@ -339,11 +369,10 @@
<!-- Returns -->
-<!ENTITY return.falseforfailture '실패시 &false;를 반환합니다.'>
-<!ENTITY return.falseforfailture.style.procedural '&style.procedural;은 실패시 &false;를 반환합니다.'>
+<!ENTITY return.falseforfailure '실패 시 &false;를 반환합니다'>
+<!ENTITY return.falseforfailure.style.procedural '&style.procedural;은 실패시 &false;를 반환합니다.'>
-<!ENTITY return.success '성공할 경우 &true;를, 실패할 경우 &false;를
-반환합니다.'>
+<!ENTITY return.success '성공 시 &true;를, &return.falseforfailure;.'>
<!ENTITY return.void '값을 반환하지 않습니다.'>
@@ -386,12 +415,9 @@
컴파일해야 합니다. (<option
role="configure">--with-freetype-dir=DIR</option>)</simpara></note>'>
-<!ENTITY note.gd.2 '<note xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 GD 2.0.1 이상이 필요합니다.
-(2.0.28 이상을 권장합니다)</simpara></note>'>
+<!ENTITY note.gd.2 '<note xmlns="http://docbook.org/ns/docbook"><para>이 함수는 GD 이미지 라이브러리가
+필요하지 않습니다.</para></note>'>
-<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><simpara>이 함수는 GD 이미지 라이브러리가
-필요하지 않습니다.</simpara></note>'>
-
<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>이 함수는 <function>imagesetinterpolation</function>으로
설정한 보간 메소드에 영향을 받습니다.</para></note>'>
@@ -440,10 +466,23 @@
<!-- JSON notes -->
-<!ENTITY json.implementation.superset '<note xmlns="http://docbook.org/ns/docbook"><para>PHP는
-JSON을 확장하여 구현합니다 - 스칼라 형과 &null;을 인코드 및 디코드 할 수 있습니다.
-JSON 표준은 배열이나 객체 안에 존재할 때만 지원합니다.
-</para></note>'>
+<!ENTITY json.implementation.superset '
+ <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <para>
+ PHP는 원래 JSON 정의(<link xlink:href="&url.rfc;4627">RFC 4627</link>)의
+ 확장셋을 구현합니다 - 스칼라 타입과 &null;을 인코드하고
+ 디코드할 수 있습니다. RFC 4627은 이 값들이 배열이나
+ 객체 안에 들어있을 때만 지원합니다.
+ </para>
+ <para>
+ 이 확장셋이 "JSON 텍스트"의 새로운 확장 정의인
+ <link xlink:href="&url.rfc;7159">RFC 7159</link>(RFC
+ 4627을 대체)와 <link xlink:href="&url.json.ecma;">ECMA-404</link>에
+ 포함되어 있지만, 하나의 스칼라 값을 인코딩 할 때 RFC 4627을
+ 엄격히 따르는 오래된 JSON 파서에서 문제를 일으킬 수 있습니다.
+ </para>
+ </note>
+'>
<!-- cURL notes -->
@@ -500,6 +539,11 @@
STREAM 모드 초기화에 사용합니다. 필요한 알고리즘에 IV를 제공하지 않을 경우, 경고를 발생하고 모든 바이트를
"<literal>\0</literal>"로 설정한 IV를 사용합니다.</para>'>
+<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">CBC, CFB, OFB 모드와 STREAM 모드의 일부 알고리즘에서 사용합니다.
+제공한 IV 크기가 체이닝 모드에서 지원하지 않거나, IV가 필수인 체이닝 모드에
+IV를 제공하지 않으면, 함수에서 경고를 보내고
+&false;를 반환합니다.</para>'>
+
<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook"><constant>MCRYPT_MODE_modename</constant> 상수 중 하나이거나, 다음 문자열 중 하나: "ecb", "cbc", "cfb", "ofb", "nofb" or "stream".</para>'>
<!-- MCVE notes -->
@@ -511,7 +555,7 @@
<!-- memcache notes -->
<!ENTITY memcached.parameter.expiration '만료 시간, 기본값은 0. 자세한 정보는
-<link xmlns="http://docbook.org/ns/docbook" linkend="memcached.expiration">만료 시간</link>을 참고하십시오.'>
+<link linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">만료 시간</link>을 참고하십시오.'>
<!ENTITY memcached.parameter.server_key '값을 저장하거나 가져올 서버를 인식하는 키. 아이템에 대한 실제 키를
해싱하는 대신에, 대화할 memcached 서버가 정해질 때 서버 키를 해시합니다. 이로써 하나의 서버에 대한 관련된
@@ -567,6 +611,23 @@
<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">여기에 있는 시간대 목록을 사용하지
마십시오(UTC 제외). 하위 호환을 위해서 남겨져 있을 뿐입니다.</simpara>'>
+<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
+ 위 경고를 무시한다면, PHP의 타임존 지원을 제공하는 IANA 타임존 데이터베이스가
+ POSIX 형식 부호를 사용하는 점에 주의하십시오.
+ <literal>Etc/GMT+n</literal>와 <literal>Etc/GMT-n</literal>
+ 타임존은 일반적인 사용과 부호가 반대입니다.
+</simpara>
+<simpara xmlns="http://docbook.org/ns/docbook">
+ 예를 들어, GMT보다 8시간 빠른 중국과 서부 호주 (그리고 다른 지역들)에서
+ 사용하는 타임존이 데이터베이스에서는 <literal>Etc/GMT-8</literal>입니다.
+ 일반적인 <literal>Etc/GMT+8</literal>과 다릅니다.
+</simpara>
+<simpara xmlns="http://docbook.org/ns/docbook">
+ 다시 한번 말하지만, 지역에 따른 정확한 타임존을 사용하기를 권합니다.
+ 위 예제처럼 <literal>Asia/Shanghai</literal>이나
+ <literal>Australia/Perth</literal> 등을 사용하십시오.
+</simpara>'>
+
<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">모든 날짜/시간 함수 호출은
시간대가 유효하지 않을 때 <constant>E_NOTICE</constant>를, 시스템 설정이나
<varname>TZ</varname> 환경 변수를 사용할 때 <constant>E_STRICT</constant>나
@@ -586,10 +647,26 @@
<type>integer</type> 유닉스 타임스탬프입니다. 즉, 기본값은
<function>time</function> 값입니다.</para></listitem></varlistentry>'>
+<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
+<listitem><para>절차식 전용: <function>date_create</function>가 반환하는
+<classname>DateTime</classname> 객체.</para></listitem></varlistentry>'>
+
+<!ENTITY date.datetimezone.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
+obejct</parameter></term><listitem><para>절차식 전용:
+<function>date_create</function>가 반환하는
+<classname>DateTime</classname> 객체. 이 함수는 객체를 변경합니다.</para></listitem></varlistentry>'>
+
+<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
+obejct</parameter></term><listitem><para>절차식 전용:
+<function>timezone_open</function>이 반환하는
+<classname>DateTimeZone</classname> 객체.</para></listitem></varlistentry>'>
+
<!ENTITY date.datetime.retval.changelog
'<row xmlns="http://docbook.org/ns/docbook"><entry>5.3.0</entry><entry>반환값을 &null;에서
<classname>DateTime</classname>으로 변경.</entry></row>'>
+<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure '메소드 체이닝을 위한 <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> 객체를 반환합니다.&return.falseforfailure;.'>
+
<!ENTITY date.timezone.dbversion '이 목록은 timezone 데이터베이스 버전에
기초하고 있습니다.'>
@@ -605,25 +682,11 @@
<!ENTITY date.timezone.pacific '태평양'>
<!ENTITY date.timezone.othres '기타'>
-<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
-<listitem><para>절차식 전용: <function>date_create</function>가 반환하는
-<classname>DateTime</classname> 객체.</para></listitem></varlistentry>'>
-<!ENTITY date.datetimezone.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
-obejct</parameter></term><listitem><para>절차식 전용:
-<function>date_create</function>가 반환하는
-<classname>DateTime</classname> 객체. 이 함수는 객체를 변경합니다.</para></listitem></varlistentry>'>
-
-<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
-obejct</parameter></term><listitem><para>절차식 전용:
-<function>timezone_open</function>이 반환하는
-<classname>DateTimeZone</classname> 객체.</para></listitem></varlistentry>'>
-
<!-- DomXml Notes -->
<!ENTITY node.inserted '이 노드는 <function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>
등을 통하여 삽입하지 않으면 보여지지 않습니다.'>
-
<!-- Dom Notes -->
<!ENTITY dom.node.inserted '이 노드는
<function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function> 등을
@@ -748,14 +811,11 @@
</para>
<para xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) introduced the
-<constant>OCI_CRED_EXT</constant> mode value. This tells Oracle to
-use
+<constant>OCI_CRED_EXT</constant> mode value. This tells Oracle to use
External or OS authentication, which must be configured in the
-database. The <constant>OCI_CRED_EXT</constant> flag can only be
-used
+database. The <constant>OCI_CRED_EXT</constant> flag can only be used
with username of "/" and a empty password.
-<link
-linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
+<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
may be <literal>On</literal> or <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
@@ -789,19 +849,13 @@
<para>이 함수는 PHP가 오라클 데이터베이스 라이브러리 버전 10<emphasis>g</emphasis>
이상과 연결되었을 때만 사용할 수 있습니다.</para></note>'>
-<!ENTITY oci.clientinfo.tip '<tip
-xmlns="http://docbook.org/ns/docbook"><title>Performance</title><para>With
-older versions of
-OCI8 or the Oracle Database, the client information can be set using
-the Oracle
-<literal>DBMS_APPLICATION_INFO</literal> package. This is less
-efficient than
+<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Performance</title><para>With older versions of
+OCI8 or the Oracle Database, the client information can be set using the Oracle
+<literal>DBMS_APPLICATION_INFO</literal> package. This is less efficient than
using <function>oci_set_client_info</function>.</para></tip>'>
-<!ENTITY oci.roundtrip.caution '<caution
-xmlns="http://docbook.org/ns/docbook"><title>Roundtrip Gotcha</title>
-<para>Some but not all OCI8 functions cause roundtrips. Roundtrips
-to the
+<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Roundtrip Gotcha</title>
+<para>Some but not all OCI8 functions cause roundtrips. Roundtrips to the
database may not occur with queries when result caching is enabled.
</para></caution>'>
@@ -812,8 +866,7 @@
</para>'>
<!ENTITY oci.arg.statement.id
-"<para xmlns='http://docbook.org/ns/docbook'>A valid OCI8
-statement
+"<para xmlns='http://docbook.org/ns/docbook'>A valid OCI8 statement
identifier created by <function>oci_parse</function> and executed
by <function>oci_execute</function>, or a <literal>REF
CURSOR</literal> statement identifier.</para>">
@@ -1025,9 +1078,8 @@
식별자.</para></listitem></varlistentry>'>
<!-- GMP Notes -->
-<!ENTITY gmp.return 'GMP 수 <type xmlns="http://docbook.org/ns/docbook">resource</type>.'>
-<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">GMP 수 <type>resource</type>나 수로 변환할 수
-있는 문자열일 수 있습니다.</para>'>
+<!ENTITY gmp.return 'PHP 5.5 이전에서는 GMP 수 <type xmlns="http://docbook.org/ns/docbook">resource</type>, PHP 5.6 이후에서는 <classname xmlns="http://docbook.org/ns/docbook">GMP</classname> 객체.'>
+<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">PHP 5.5 이전에서 GMP 수 <type>resource</type>나, PHP 5.6 이후에서 <classname xmlns="http://docbook.org/ns/docbook">GMP</classname> 객체, 또는 수로 변환할 수 있는 문자열일 수 있습니다.</para>'>
<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description
@@ -1050,9 +1102,10 @@
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd는 항상 서버 기본 문자셋을 가정합니다. 이 문자셋은 접속/인증 중에 보내져서 mysqlnd가 사용하게 합니다.</para><para>Libmysqlclient는 <filename>my.cnf</filename>의 기본 문자셋을 사용하거나, <function>mysqli_init</function> 이후, <function>mysqli_real_connect</function> 이전에 명시적으로 호출한 <function>mysqli_options</function>로 지정할 수 있습니다.</para></note>'>
+
<!-- Notes for SAPI/Apache -->
<!ENTITY note.apache.nsapi-module '<para xmlns="http://docbook.org/ns/docbook">PHP 4.3.3부터 이 함수를
-넷스케이프/iPlanet/SunONE 웹서버의 <link linkend="ref.nsapi">NSAPI 서버
+넷스케이프/iPlanet/SunONE 웹서버의 <link linkend="book.nsapi">NSAPI 서버
모듈</link>에서도 사용할 수 있습니다.</para>'>
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">이 함수는 PHP를 아파치 모듈로 설치하였을
@@ -1762,26 +1815,29 @@
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the write concern. The array contains the values <literal>w</literal> for an integer acknowledgement level or string mode, and <literal>wtimeout</literal> denoting the maximum number of milliseconds to wait for the server to satisfy the write concern.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Specifies a cumulative time limit in milliseconds for processing the operation (does not include idle time). If the operation is not completed within the timeout period, a <classname>MongoExecutionTimeoutException</classname> will be thrown.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Builds the index in the background so that building an index does <emphasis>not</emphasis> block other database activities. Specify &true; to build in the background. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Building Indexes with Replica Sets</link> for more information.</para></warning></listitem>'>
-<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Specify &true; to force creation of a unique index that may have duplicates. MongoDB will index the first occurrence of a key and delete all documents from the collection that contain subsequent occurrences of that key. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> may delete data from your database. Use with extreme caution.</para></warning></listitem>'>
+<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Specify &true; to force creation of a unique index where the collection may contain duplicate values for a key. MongoDB will index the first occurrence of a key and delete all subsequent documents from the collection that contain a duplicate value for that key. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> may delete data from your database. Use with extreme caution.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>This option is not supported on MongoDB 2.8+. Index creation will fail if the collection contains duplicate values.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>The value of this option should specify the number of seconds after which a document should be considered expired and automatically removed from the collection. This option is only compatible with single-field indexes where the field will contain <classname>MongoDate</classname> values.</para><note xmlns="http://docbook.org/ns/docbook"><para>This feature is available in MongoDB 2.2+. See <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Expire Data from Collections by Setting TTL</link> for more information.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>A optional name that uniquely identifies the index.</para><note xmlns="http://docbook.org/ns/docbook"><para>By default, the driver will generate an index name based on the index's field(s) and ordering or type. For example, a compound index <literal>array("x" => 1, "y" => -1)</literal> would be named <literal>"x_1_y_-1"</literal> and a geospatial index <literal>array("loc" => "2dsphere")</literal> would be named <literal>"loc_2dsphere"</literal>. For indexes with many fields, it is possible that the generated name might exceed MongoDB's <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">limit for index names</link>. The <literal>"name"</literal> option may be used in that case to supply a shorter name.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Specify &true; to create a sparse index, which only indexes documents containing a specified field. The default value is &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Specify &true; to create a unique index. The default value is &false;. This option applies only to ascending/descending indexes.</para><note xmlns="http://docbook.org/ns/docbook"><para>When MongoDB indexes a field, if a document does not have a value for the field, a &null; value is indexed. If multiple documents do not contain a field, a unique index will reject all but the first of those documents. The <literal>"sparse"</literal> option may be used to overcome this, since it will prevent documents without the field from being indexed.</para></note></listitem>'>
+<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>This method will use the <link xlink:href="&url.mongodb.dochub.listcollections;" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> database command when communicating with MongoDB 2.8+. For previous database versions, the method will query the special <literal>system.namespaces</literal> collection.</simpara></note>'>
+<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Optional query criteria. If provided, this criteria will be used to filter the collections included in the result.</para><para>Relevant fields that may be queried include <literal>"name"</literal> (collection name as a string, without the database name prefix) and <literal>"options" (object containing options used to create the collection).</literal>.</para><note><simpara>MongoDB 2.6 and earlier versions require the <literal>"name"</literal> criteria, if specified, to be a string value (i.e. equality match). This is because the driver must prefix the value with the database name in order to query the <literal>system.namespaces</literal> collection. Later versions of MongoDB do not have this limitation, as the driver will use the listCollections command.</simpara></note></listitem>'>
+<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Boolean, defaults to &false;. Determines whether system collections should be included in the result.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>See <link linkend="mongo.writeconcerns">Write Concerns</link>. The default value for <classname>MongoClient</classname> is <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Deprecated alias for <literal>"wTimeoutMS"</literal>.</para></listitem>'>
-<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>How long to wait for <link linkend="mongo.writeconcerns">write concern</link> acknowledgement. The default value for <classname>MongoClient</classname> is <literal>10000</literal> milliseconds.</para></listitem>'>
+<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for <link linkend="mongo.writeconcerns">write concern</link> acknowledgement. It is only applicable when <literal>"w"</literal> is greater than <literal>1</literal>, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a <classname>MongoCursorException</classname> will be thrown. A value of <literal>0</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>10000</literal> (ten seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Boolean, defaults to &false;. If journaling is enabled, it works exactly like <literal>"j"</literal>. If journaling is not enabled, the write operation blocks until it is synced to database files on disk. If &true;, an acknowledged insert is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If journaling is enabled, users are strongly encouraged to use the <literal>"j"</literal> option instead of <literal>"fsync"</literal>. Do not use <literal>"fsync"</literal> and <literal>"j"</literal> simultaneously, as that will result in an error.</simpara></note></listitem>'>
-<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>Integer, defaults to <literal>MongoCursor::$timeout</literal>. If acknowledged writes are used, this sets how long (in milliseconds) for the client to wait for a database response. If the database does not respond within the timeout period, a <classname>MongoCursorTimeoutException</classname> will be thrown.</para></listitem>'>
+<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a <classname>MongoCursorTimeoutException</classname> will be thrown and there will be no way to determine if the server actually handled the write or not. A value of <literal>-1</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>30000</literal> (30 seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Boolean, defaults to &false;. Forces the write operation to block until it is synced to the journal on disk. If &true;, an acknowledged write is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Deprecated. Please use the <link linkend="mongo.writeconcerns">write concern</link> <literal>"w"</literal> option.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Deprecated alias for <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
-<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorException</classname> if the <literal>"w"</literal> option is set and the write fails.</para><para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorTimeoutException</classname> if the <literal>"w"</literal> option is set to a value greater than one and the operation takes longer than <varname>MongoCursor::$timeout</varname> milliseconds to complete. This does not kill the operation on the server, it is a client-side timeout. The operation in <literal>MongoCollection::$wtimeout</literal> is milliseconds.</para>'>
+<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorException</classname> if the <literal>"w"</literal> option is set and the write fails.</para><para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorTimeoutException</classname> if the <literal>"w"</literal> option is set to a value greater than one and the operation takes longer than <varname>MongoCursor::$timeout</varname> milliseconds to complete. This does not kill the operation on the server, it is a client-side timeout. The operation in <varname>MongoCollection::$wtimeout</varname> is milliseconds.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Issues <constant>E_DEPRECATED</constant> warning</para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>These fields may also overwrite those that would be created automatically by the driver, as described in the MongoDB core documentation for the <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">files collection</link>. Some practical use cases for this behavior would be to specify a custom <literal>chunkSize</literal> or <literal>_id</literal> for the file.</para></note>'>
-<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Returns the <literal>_id</literal> of the saved file document. This will be a generated <classname>MongoId</classname> unless an <literal>_id</literal> was explicitly specified in the <parameter>extra</parameter> parameter.</para>'>
+<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Returns the <literal>_id</literal> of the saved file document. This will be a generated <classname>MongoId</classname> unless an <literal>_id</literal> was explicitly specified in the <parameter>metadata</parameter> parameter.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>An array of Write Options.<informaltable><thead><row><entry>key</entry><entry>value meaning</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry><link linkend="mongo.writeconcerns">Write concern</link> value</entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Maximum time to wait for replication</link></entry></row><row><entry>ordered</entry><entry>Determins if MongoDB must apply this batch in order (sequentally, one item at a time) or can rearrange it. Defaults to &true;</entry></row><row><entry>j (bool)</entry><entry>Wait for journaling on the primary. This value is discouraged, use WriteConcern instead</entry></row><row><entry>fsync (bool)</entry><entry>Wait for fsync on the primary. This value is discouraged, use WriteConcern instead</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>The <classname>MongoCollection</classname> to execute the batch on. Its <link linkend="mongo.writeconcerns">write concern</link> will be copied and used as the default write concern if none is given as <parameter>$write_options</parameter> or during <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
-<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> An array containing the basic information about the server that was picked. <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>server hash, example: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Node type (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>The maximum BSON Size over the wire this node accepts: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>The maximum Message Size over the wire this node accepts: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'> <!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'> <!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
+<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> An array containing the basic information about the server that was picked. <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>server hash, example: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Node type (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>The maximum BSON Size over the wire this node accepts: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>The maximum Message Size over the wire this node accepts: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'> <!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'> <!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>A request must be created via <function>radius_create_request</function> before this function can be called.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>The attribute type.</para></listitem></varlistentry>'>
@@ -1790,6 +1846,76 @@
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>The attribute tag. This parameter is ignored unless the <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> option is set.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>The vendor ID.</para></listitem></varlistentry>'>
+<!-- posix snippets -->
+<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>fd</parameter></term>
+ <listitem>
+ <para>
+ The file descriptor, which is expected to be either a file
+ <type>resource</type> or an <type>integer</type>. An <type>integer</type>
+ will be assumed to be a file descriptor that can be passed directly to
+ the underlying system call.
+ </para>
+ <para>
+ In almost all cases, you will want to provide a file <type>resource</type>.
+ </para>
+ </listitem>
+</varlistentry>'>
+
+<!-- strings snippets -->
+<!ENTITY strings.parameter.encoding '
+ <para xmlns="http://docbook.org/ns/docbook">
+ An optional argument defining the encoding used when converting characters.
+ </para>
+
+ <para xmlns="http://docbook.org/ns/docbook">
+ If omitted, the default value of the <parameter>encoding</parameter> varies
+ depending on the PHP version in use. In PHP 5.6 and later, the
+ <link linkend="ini.default-charset">default_charset</link> configuration
+ option is used as the default value. PHP 5.4 and 5.5 will use
+ <literal>UTF-8</literal> as the default. Earlier versions of PHP use
+ <literal>ISO-8859-1</literal>.
+ </para>
+
+ <para xmlns="http://docbook.org/ns/docbook">
+ Although this argument is technically optional, you are highly encouraged to
+ specify the correct value for your code if you are using PHP 5.5 or earlier,
+ or if your <link linkend="ini.default-charset">default_charset</link>
+ configuration option may be set incorrectly for the given input.
+ </para>
+'>
+
+<!ENTITY strings.changelog.encoding '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>5.6.0</entry>
+ <entry>
+ The default value for the <parameter>encoding</parameter> parameter was
+ changed to be the value of the
+ <link linkend="ini.default-charset">default_charset</link> configuration
+ option.
+ </entry>
+ </row>
+'>
+
+<!-- filter snippets -->
+<!ENTITY filter.param.filter '
+ <varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>filter</parameter></term>
+ <listitem>
+ <para>
+ The ID of the filter to apply. The <xref linkend="filter.filters" />
+ manual page lists the available filters.
+ </para>
+ <para>
+ If omitted, <constant>FILTER_DEFAULT</constant> will be used, which is
+ equivalent to
+ <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
+ This will result in no filtering taking place by default.
+ </para>
+ </listitem>
+ </varlistentry>
+'>
+
<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
<para xmlns="http://docbook.org/ns/docbook">
@@ -1814,9 +1940,28 @@
certificate verification for a request by setting the
<link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
context option to &false;, and to disable peer name validation by setting
- the
- <parameter>verify_peer_name</parameter>
- <!--<link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>-->
+ the <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
context option to &false;.
</para>
'>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: fen fdm=syntax fdl=2 si
+vim: et tw=78
+vi: ts=1 sw=1
+-->