noribsd Sat Feb 24 14:03:54 2001 EDT
Modified files:
/phpdoc/kr/functions http.xml
Log:
modified words spacing and tags spacing look more clear
Index: phpdoc/kr/functions/http.xml
diff -u phpdoc/kr/functions/http.xml:1.4 phpdoc/kr/functions/http.xml:1.5
--- phpdoc/kr/functions/http.xml:1.4 Fri Feb 23 21:27:13 2001
+++ phpdoc/kr/functions/http.xml Sat Feb 24 14:03:54 2001
@@ -1,189 +1,245 @@
- <reference id="ref.http">
- <title>HTTP functions</title>
- <titleabbrev>HTTP</titleabbrev>
-
- <partintro>
- <simpara> 여기 설명되어질 함수들은 원격브라우저에 보내질
각종 출력들을 HTTP 프로토콜에 충실히 기반하여 다룰 수 있게
해준다.
- </simpara>
- </partintro>
-
- <refentry id="function.header">
- <refnamediv>
- <refname>header</refname>
- <refpurpose>HTTP 헤더를 전송한다.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>함수 설명</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>header</function></funcdef>
- <paramdef>string <parameter>string</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para> <function>Header</function> 함수는 <acronym>HTML</acronym> 파일
상단에 <acronym>HTTP</acronym> 헤더 문자열을 전송한다. HTTP 헤더에
대한 자세한 정보는 <ulink url="&spec.http1.1;">HTTP 1.1
Specification</ulink> 를 참조하기 바란다.
- </para>
- <para> 헤더와 관련된 두가지 특별한 경우가 있다. 첫번째로
"Location " 헤더에 대해 설명하겠다. 이것은 지정된
헤더내용을 브라우저에 전송하면서 동시에 아파치 서버로
REDIRECT 코드(REDIRECT status code)를 돌려준다. 스크립트 작성자의
관점으로 볼때 이것은 별로 중요한 것이 아니지만 아파치
내부동작에 관심이 있는 사람들은 알아두어야 할 것이다.
<informalexample>
- <programlisting role="php">
-header ("Location: http://www.php.net"); /* PHP 웹사이트로
- 리다이렉트한다. */
-exit; /* 리다이렉트되고 있을때 아래에 있는
- 코드가 실행되지 않도록 한다 */
- </programlisting>
- </informalexample>
- </para>
- <para> 두번째는 "HTTP/" 문자열로 시작하는 헤더를 사용하는
경우이다. (대소문자는 상관없음) 예를 들어, 아파치의
ErrorDocument 404 지시자가 여러분의 PHP 스크립트를 가리키게
해두었다면 그 스크립트가 실제로 404 코드를 생성하고
있는지 확실히 해두는 것이 좋다. 아래의 예를 참조하라.
<informalexample>
- <programlisting role="php">
-header ("HTTP/1.0 404 Not Found");
- </programlisting>
- </informalexample>
- </para>
- <para> PHP 스크립트를 사용하다보면 클라이언트 브라우저와
프록시서버에 캐쉬되지 말아야할 출력(예: 다이내믹 HTML)을
만들어야 할 경우가 있다. 이럴 경우 아래와 같이
클라이언트와 프록시서버의 캐쉬기능을 강제로 해제할 수 있다.
<informalexample>
- <programlisting role="php">
-header ("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Date in the past
-header ("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
- // always modified
-header ("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
-header ("Pragma: no-cache"); // HTTP/1.0
- </programlisting>
- </informalexample>
- </para>
- <para> <function>header</function> 함수는 HTML의 공백라인이나
PHP가 만들어낸 어떠한 출력보다도 가장 먼저 호출되어야
한다. <function>header</function> 함수가 호출되기 전에
<function>include</function> 와 <function>require</function> 혹은 기타 다른
파일엑세스 관련 함수를 사용하거나 코드내에 공백을 넣는
경우는 스크립트 작성자가 흔히 저지르는 실수이다. 설령
PHP/HTML 파일 하나만 사용한다고 해도 이같은 실수의 가능성은
여전히 존재한다.
- <informalexample>
- <programlisting role="php">
-<?php require("user_logging.inc") ?>
-
-
-<?php header ("Content-Type: audio/x-pn-realaudio"); ?>
-// 윗줄에 공백이 있으므로 제대로 동작하지 않을 것이다.
- </programlisting>
- </informalexample>
- </para>
- <para>
- <function>headers_sent</function>도 참고하라.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.headers-sent">
- <refnamediv>
- <refname>headers_sent</refname>
- <refpurpose>헤더가 전송되었으면 참(true)을 돌려준다.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>함수 설명</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>boolean <function>headers_sent</function></funcdef>
- <paramdef><parameter>void</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- 이 함수는 HTTP 헤더가 이미 전송되어진 경우 참(true)을,
반대의 경우 거짓(false)을 돌려준다. </para>
- <para>
- <function>header</function>도 참고하라.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.setcookie">
- <refnamediv>
- <refname>setcookie</refname>
- <refpurpose>쿠키를 설정한다.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>setcookie</function></funcdef>
- <paramdef>string <parameter>name</parameter></paramdef>
- <paramdef>string
- <parameter><optional>value</optional></parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>expire</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>path</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>domain</optional></parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>secure</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para> <function>Setcookie</function> 함수는 쿠키를 설정하기 위해
쓰인다. 쿠키는 다른 어떠한 헤더보다도
<emphasis>먼저</emphasis> 전송되어야 한다. (이것은 PHP와는
상관없는 쿠키 자체의 제약이다) 즉, 이 함수를 쓰기 위해서
는 <literal><html></literal> 이나 <literal><head></literal> 내부에
오는 어떠한 태그들 보다 먼저 호출되어야 하는 것이다. </para>
- <para> <parameter>name</parameter> 을 제외한 모든 인수들은
선택적으로 주어질 수 있다. (만약 <parameter>name</parameter>인수만
주어진 경우 그 이름을 가진 쿠키는 모두 삭제될 것이다).
또한 주어지지 않은 인수를 빈 문자열
(<emphasis>""</emphasis>) 로 대체할 수 있다.
<emphasis>expire</emphasis> 와 <emphasis>secure</emphasis> 인수는 정수값
이며, 주어지지 않을 경우 빈 문자열로 대체될 수 없는 대신 숫자
0 으로 대체할 수 있다. <emphasis>expire</emphasis> 인수는 표준
유닉스 시간으로 <function>time</function> 이나
<function>mktime</function> 함수가 돌려보내는 정수값을 쓸 수
있다. <function>secure</function> 인수가 지정된 쿠키는 안전한 HTTPS
접속에서만 전송이 허용된다. </para>
- <para>
- 주의해야할 사항:
- <itemizedlist>
- <listitem>
- <simpara>
- 쿠키는 그 쿠키를 유효하게 하기 위해 페이지를
재로딩하기 전까지는 작동 되지 않는다. </simpara>
- </listitem>
- <listitem>
- <simpara>
- 쿠키는 생성될 당시의 인수(parameter)를 그대로 넣어
삭제해야 한다. </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <simpara> PHP3는 <function>setcookie</function> 함수가 하나의
스크립트 안에서 여러번 호출된 경우 그 호출된 역순으로
처리를 한다. 이 경우 새로운 쿠키를 하나 추가하기 전에
기존의 쿠키를 하나 삭제하려면 추가하는 구문이 삭제하는
구문보다 먼저 놓여야 원하는 결과를 얻을 수 있다. 반대로 PHP4는
여러번 호출된 <function>setcookie</function> 함수들을 호출된 순서
그대로 처리한다.
- </simpara>
- <para>
- 아래는 쿠키를 전송하는 예제이다: <example>
- <title><function>Setcookie</function> send examples</title>
- <programlisting role="php">
-setcookie ("TestCookie", "Test Value");
-setcookie ("TestCookie", $value,time()+3600); /* expire in 1 hour */
-setcookie ("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1);
- </programlisting>
- </example>
- </para>
- <para>
- 아래는 위의 예제에서 전송한 쿠키를 삭제하는 예제이다:
- <example>
- <title><function>setcookie</function> delete examples</title>
- <programlisting role="php">
-setcookie ("TestCookie");
-// 만료시기를 한시간 전으로 설정
-setcookie ("TestCookie", "", time() - 3600);
-setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);
- </programlisting>
- </example>
- 쿠키를 삭제하려면 인수로 주어질 만료시기가 만료시점을
기준으로 과거를 가리키고 있는지 확인해야 한다. </para>
- <para>
- 쿠키의 일부분은 필요한 경우 자동적으로
url인코딩(urlencoded)이 된후 전송이 되며, 그것을 다시 받을
경우에도 자동적인 디코딩 및 쿠키 이름에 해당하는
변수할당이 이루어진다. 자세한 사항은 아래의 예제를 참조하라:
<informalexample>
- <programlisting role="php">
-echo $TestCookie;
-echo $HTTP_COOKIE_VARS["TestCookie"];
- </programlisting>
- </informalexample>
- </para>
- <para>
- 또한 여러분은 쿠키 이름에 배열기수법(array notation)을
활용하여 배열형태의 쿠키(array cookies)를 만들 수 있다.
이러한 방법은 당신이 가지 고 있는 배열요소의 갯수만큼
동일한 갯수의 쿠키를 설정할 수 있으며, 이러한 방법으로
설정된 쿠키를 가져올 때에는 각각의 쿠키값들이 설정당시의
쿠키이름을 활용한 배열의 형태로 변수할당이 이루어진다.
<informalexample>
- <programlisting role="php">
-setcookie ("cookie[three]", "cookiethree");
-setcookie ("cookie[two]", "cookietwo");
-setcookie ("cookie[one]", "cookieone");
-if (isset ($cookie)) {
- while (list ($name, $value) = each ($cookie)) {
- echo "$name == $value<br>\n";
- }
-}
- </programlisting>
- </informalexample>
- </para>
- <para> 쿠키에 대한 자세한 정보는 넷스케이프에서
제공하는 <ulink url="&spec.cookies;">&spec.cookies;</ulink> 문서를
참조하기 바란다. </para>
- <simpara>
- 경로인수(path parameter set)와 함께 설정된 쿠키는 서비스팩 1
이 적용된 마이크로소프트 인터넷 익스플로러 4 에서 제대로
동작하지 않는다. </simpara>
- <simpara>
- 경로인수(path)와 만료시기(time)가 설정되지 않은 쿠키는
넷스케이프 커뮤니케이터 4.05 와 마이크로소프트 인터넷
익스플로러 3.x 에서 제대로 동작하지 않는다. </simpara>
- </refsect1>
- </refentry>
-
- </reference>
-
+<reference id="ref.http">
+ <title>HTTP functions</title>
+ <titleabbrev>HTTP</titleabbrev>
+ <partintro>
+ <simpara>
+ 여기 설명되어질 함수들은 원격브라우저에 보내질
+각종 출력들을 HTTP 프로토콜에 충실히 기반하여 다룰 수 있게
+해준다.
+ </simpara>
+ </partintro>
+ <refentry id="function.header">
+ <refnamediv>
+ <refname>header</refname>
+ <refpurpose>HTTP 헤더를 전송한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>함수 설명</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>header</function>
+ </funcdef>
+ <paramdef>string <parameter>string</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Header</function> 함수는
+<acronym>HTML</acronym> 파일 상단에 <acronym>HTTP</acronym> 헤더 문자열을
+전송한다.
+ HTTP 헤더에 대한 자세한 정보는 <ulink
+url="&spec.http1.1;">HTTP 1.1 Specification</ulink> 를 참조하기 바란다.
+ </para>
+ <para>
+ 헤더와 관련된 두가지 특별한 경우가 있다.
+첫번째로 "Location" 헤더에 대해 설명하겠다. 이것은
+지정된 헤더내용을 브라우저에
+ 전송하면서 동시에 아파치 서버로 REDIRECT
+코드(REDIRECT status code)를 돌려준다. 스크립트 작성자의 관점으로
+볼때 이것은 별로
+ 중요한 것이 아니지만 아파치 내부동작에
+관심이 있는 사람들은 알아두어야 할 것이다.
+ <informalexample>
+ <programlisting role="php">
+ header ("Location: http://www.php.net"); /* PHP
+웹사이트로
+
+ 리다이렉트한다. */
+ exit; /* 리다이렉트되고 있을때
+아래에 있는 코드가
+ 실행되지 않도록 한다
+*/
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 두번째는 "HTTP/" 문자열로 시작하는 헤더를
+사용하는 경우이다. (대소문자는 상관없음) 예를 들어, 아파치의
+ErrorDocument 404 지시자가
+ 여러분의 PHP 스크립트를 가리키게
+해두었다면 그 스크립트가 실제로 404 코드를 생성하고
+있는지 확실히 해두는 것이 좋다. 아래의 예를 참조하라.
+ <informalexample>
+ <programlisting role="php">
+ header ("HTTP/1.0 404 Not Found");
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ PHP 스크립트를 사용하다보면 클라이언트
+브라우저와 프록시서버에 캐쉬되지 말아야할 출력(예: 다이내믹
+HTML)을 만들어야 할 경우가 있다.
+ 이럴 경우 아래와 같이 클라이언트와
+프록시서버의 캐쉬기능을 강제로 해제할 수 있다.
+ <informalexample>
+ <programlisting role="php">
+ header ("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); //
+Date in the past
+ header ("Last-Modified: " . gmdate("D, d M Y H:i:s") . "
+GMT");
+
+ // always modified
+ header ("Cache-Control: no-cache, must-revalidate"); //
+HTTP/1.1
+ header ("Pragma: no-cache"); //
+HTTP/1.0
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ <function>header</function> 함수는 HTML의
+공백라인이나 PHP가 만들어낸 어떠한 출력보다도 가장 먼저
+호출되어야 한다. <function>header</function>
+ 함수가 호출되기 전에
+<function>include</function> 와 <function>require</function> 혹은 기타 다른
+파일엑세스 관련 함수를 사용하거나 코드내에 공백을
+ 넣는 경우는 스크립트 작성자가 흔히
+저지르는 실수이다. 설령 PHP/HTML 파일 하나만 사용한다고 해도
+이같은 실수의 가능성은 여전히 존재한다.
+ <informalexample>
+ <programlisting role="php">
+ <?php require("user_logging.inc") ?>
+
+
+ <?php header ("Content-Type: audio/x-pn-realaudio"); ?>
+ // 윗줄에 공백이 있으므로 제대로 동작하지
+않을 것이다.
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ <function>headers_sent</function>도 참고하라.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.headers-sent">
+ <refnamediv>
+ <refname>headers_sent</refname>
+ <refpurpose>헤더가 전송되었으면 참(true)을
+돌려준다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>함수 설명</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean
+<function>headers_sent</function>
+ </funcdef>
+ <paramdef>
+ <parameter>void</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 이 함수는 HTTP 헤더가 이미 전송되어진 경우
+참(true)을, 반대의 경우 거짓(false)을 돌려준다.
+ </para>
+ <para>
+ <function>header</function>도 참고하라.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.setcookie">
+ <refnamediv>
+ <refname>setcookie</refname>
+ <refpurpose>쿠키를 설정한다.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>setcookie</function>
+ </funcdef>
+ <paramdef>string <parameter>name</parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>value</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>expire</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>path</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>domain</optional>
+ </parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>secure</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Setcookie</function> 함수는 쿠키를
+설정하기 위해 쓰인다. 쿠키는 다른 어떠한 헤더보다도
+<emphasis>먼저</emphasis> 전송되어야 한다.
+ (이것은 PHP와는 상관없는 쿠키 자체의
+제약이다) 즉, 이 함수를 쓰기 위해서는 <literal><html></literal>
+이나 <literal><head></literal> 내부에 오는
+ 어떠한 태그들 보다 먼저 호출되어야
+하는 것이다.
+ </para>
+ <para>
+ <parameter>name</parameter> 을 제외한 모든
+인수들은 선택적으로 주어질 수 있다. (만약
+<parameter>name</parameter>인수만 주어진 경우 그 이름을 가진
+ 쿠키는 모두 삭제될 것이다). 또한
+주어지지 않은 인수를 빈 문자열 (<emphasis>""</emphasis>) 로
+대체할 수 있다. <emphasis>expire</emphasis> 와
+ <emphasis>secure</emphasis> 인수는 정수값이며,
+주어지지 않을 경우 빈 문자열로 대체될 수 없는 대신 숫자 0
+으로 대체할 수 있다. <emphasis>expire</emphasis>
+ 인수는 표준 유닉스 시간으로
+<function>time</function> 이나 <function>mktime</function> 함수가
+돌려보내는 정수값을 쓸 수 있다. <function>secure</function>
+ 인수가 지정된 쿠키는 안전한 HTTPS
+접속에서만 전송이 허용된다.
+ </para>
+ <para>
+ 주의해야할 사항:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ 쿠키는 그 쿠키를 유효하게 하기 위해
+페이지를 재로딩하기 전까지는 작동되지 않는다.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 쿠키는 생성될 당시의 인수(parameter)를
+그대로 넣어 삭제해야 한다.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <simpara>
+ PHP3는 <function>setcookie</function> 함수가 하나의
+스크립트 안에서 여러번 호출된 경우 그 호출된 역순으로
+처리를 한다. 이 경우 새로운 쿠키를
+ 하나 추가하기 전에 기존의 쿠키를 하나
+삭제하려면 추가하는 구문이 삭제하는 구문보다 먼저 놓여야
+원하는 결과를 얻을 수 있다. 반대로 PHP4는 여러번
+ 호출된 <function>setcookie</function> 함수들을
+호출된 순서 그대로 처리한다.
+ </simpara>
+ <para>
+ 아래는 쿠키를 전송하는 예제이다:
+ <example>
+ <title>
+ <function>Setcookie</function> send
+examples</title>
+ <programlisting role="php">
+ setcookie ("TestCookie", "Test Value");
+ setcookie ("TestCookie", $value,time()+3600); /*
+만료시기를 1시간 후로 설정 */
+ setcookie ("TestCookie", $value,time()+3600, "/~rasmus/",
+".utoronto.ca", 1);
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ 아래는 위의 예제에서 전송한 쿠키를 삭제하는
+예제이다:
+ <example>
+ <title>
+ <function>setcookie</function> delete
+examples</title>
+ <programlisting role="php">
+ setcookie ("TestCookie");
+ // 만료시기를 한시간 전으로 설정
+ setcookie ("TestCookie", "", time() - 3600);
+ setcookie ("TestCookie", "", time() - 3600, "/~rasmus/",
+".utoronto.ca", 1);
+ </programlisting>
+ </example>
+ 쿠키를 삭제하려면 인수로 주어질 만료시기가
+만료시점을 기준으로 과거를 가리키고 있는지 확인해야 한다.
+ </para>
+ <para>
+ 쿠키의 일부분은 필요한 경우 자동적으로
+url인코딩(urlencoded)이 된후 전송이 되며, 그것을 다시 받을
+경우에도 자동적인 디코딩 및 쿠키 이름에
+ 해당하는 변수할당이 이루어진다. 자세한 사항은
+아래의 예제를 참조하라:
+ <informalexample>
+ <programlisting role="php">
+ echo $TestCookie;
+ echo $HTTP_COOKIE_VARS["TestCookie"];
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 또한 여러분은 쿠키 이름에 배열기수법(array
+notation)을 활용하여 배열형태의 쿠키(array cookies)를 만들 수 있다.
+이러한 방법은 당신이 가지고
+ 있는 배열요소의 갯수만큼 동일한 갯수의 쿠키를
+설정할 수 있으며, 이러한 방법으로 설정된 쿠키를 가져올
+때에는 각각의 쿠키값들이 설정당시의
+ 쿠키이름을 활용한 배열의 형태로 변수할당이
+이루어진다.
+ <informalexample>
+ <programlisting role="php">
+ setcookie ("cookie[three]", "cookiethree");
+ setcookie ("cookie[two]", "cookietwo");
+ setcookie ("cookie[one]", "cookieone");
+ if (isset ($cookie)) {
+ while (list ($name, $value) = each ($cookie)) {
+ echo "$name == $value<br>\n";
+ }
+ }
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 쿠키에 대한 자세한 정보는 넷스케이프에서
+제공하는 <ulink url="&spec.cookies;">&spec.cookies;</ulink> 문서를
+참조하기 바란다.
+ </para>
+ <simpara>
+ 경로인수(path parameter set)와 함께 설정된 쿠키는
+서비스팩 1 이 적용된 마이크로소프트 인터넷 익스플로러 4 에서
+제대로 동작하지 않는다.
+ </simpara>
+ <simpara>
+ 경로인수(path)와 만료시기(time)가 설정되지 않은
+쿠키는 넷스케이프 커뮤니케이터 4.05 와 마이크로소프트 인터넷
+익스플로러 3.x 에서 제대로 동작하지 않는다.
+ </simpara>
+ </refsect1>
+ </refentry>
+</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
