Contents of the Accept: header from the current request, if there is one.

Contents of the Accept-Charset: header from the current request, if there is one. Example: 'iso-8859-1,*,utf-8'.

Contents of the Accept-Encoding: header from the current request, if there is one. Example: 'gzip'.

Contents of the Accept-Language: header from the current request, if there is one. Example: 'en'.

Contents of the Connection: header from the current request, if there is one. Example: 'Keep-Alive'.

Contents of the Host: header from the current request, if there is one.

The address of the page (if any) which referred the browser to the current page. This is set by the user's browser; not all browsers will set this.

Contents of the User_Agent: header from the current request, if there is one. This is a string denoting the browser software being used to view the current page; i.e. Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586). Among other things, you can use this value with get_browser() to tailor your page's functionality to the capabilities of the user's browser.

The IP address from which the user is viewing the current page.

The port being used on the user's machine to communicate with the web server.

The absolute pathname of the currently executing script.

The value given to the SERVER_ADMIN (for Apache) directive in the web server configuration file. If the script is running on a virtual host, this will be the value defined for that virtual host.

The port on the server machine being used by the web server for communication. For default setups, this will be '80'; using SSL, for instance, will change this to whatever your defined secure HTTP port is.

String containing the server version and virtual host name which are added to server-generated pages, if enabled.

Filesystem- (not document root-) based path to the current script, after the server has done any virtual-to-real mapping.

Contains the current script's path. This is useful for pages which need to point to themselves.

The URI which was given in order to access this page; for instance, '/index.html'.

Environment variables

These variables are imported into PHP's global namespace from the environment under which the PHP parser is running. Many are provided by the shell under which PHP is running and different systems are likely running different kinds of shells, a definitive list is impossible. Please see your shell's documentation for a list of defined environment variables.

Other environment variables include the CGI variables, placed there regardless of whether PHP is running as a server module or CGI processor.

변수 사용 범위 (Variable Scope)

변수가 사용가능한 곳은 그 변수가 선언된 곳 안에서 만이다. PHP 변수의 대부분은 한 개의 범위(single scope)만을 가지고 있다. 이 범위는 include나 require 파일에도 동일하게 적용된다. 예를들어 :

  1 
  2 $a = 1;
  3 include "b.inc";
  4     

위에서 $a변수는 b,inc 스크립트에서도 사용할 수 있다.

기본적으로 함수 안에서 선언된 것은 함수 안에서만 사용되는 지역 변수이다. 또한 함수 안에서 사용되는 함수들은 기본적으로 지역 변수라고 가정하고 찾게 된다. 예를 들어:

  1  
  2 $a = 1; /* global scope */ 
  3 
  4 Function Test () { 
  5     echo $a; /* reference to local scope variable */ 
  6 } 
  7 
  8 Test ();
  9     

이 스크립트는 함수 안의 $a 변수를 지역변수로 가정하였고, 지역변수 $a에는 아무 값도 대입되지 않았기 때문에 아무런 출력도 나타나지 않는다. 이것은 C와는 약간 차이가 나는 부분이다. PHP에서 전역변수를 사용하려면 사용하고 싶은 전역 변수를 함수 안에 global 선언을 해 주어야 한다. 예를 들어 :

  1 
  2 $a = 1;
  3 $b = 2;
  4 
  5 Function Sum () {
  6     global $a, $b;
  7 
  8     $b = $a + $b;
  9 } 
 10 
 11 Sum ();
 12 echo $b;
 13     

위의 스크립트는 "3"을 출력할 것이다. 함수 내에서 $a and $b를 global로 선언했으므로, 이 함수내의 $a, $b는 전역 변수를 참조하게 된다. 함수 내에서 다룰 수 있는 전역변수의 개수에는 제한이 없다.

전역 변수를 참조하는 두 번째 방법은 PHP에서 특별히 정의하고 있는 $GLOBALS라는 배열을 사용하는 것이다. 위의 예를 다음과 같이 바꿔 쓸 수 있다. :

  1 
  2 $a = 1;
  3 $b = 2;
  4 
  5 Function Sum () {
  6     global $a, $b;
  7 
  8     $b = $a + $b;
  9 } 
 10 
 11 Sum ();
 12 echo $b;
 13     

$GLOBALS 배열은 변수이름이 Key가 되고, 그 변수의 내용이 값이 되는 원소를 가진 associative 배열이다.

변수 범위에서 또 다른 중요한 것은 정적 변수(static variable)이다. 정적 변수는 지역 함수 내에서만 존재하지만 지역 함수가 종료되어도 그 값을 읽어버리지 않고 가지고 있다. 다음 예를 보자 :

  1 
  2 Function Test () {
  3     $a = 0;
  4     echo $a;
  5     $a++;
  6 }
  7     

위의 함수는 Test()를 부를 때 마다 $a가 0으로 대입되므로 0을 출력한다.

  1 
  2 Function Test () {
  3     static $a = 0;
  4     echo $a;
  5     $a++;
  6 }
  7     

위의 함수는 Test()를 부를 때마다 처음에는 0, 다음에는 1, 그 다음에는 2하는 식으로 하나씩 증가된 수를 출력해 준다. 즉, $a의 값이 보존되는 것이다.

또한 정적 변수는 다음과 같이 recursion에서 반드시 필요하다. 재귀적인 함수는 자기 자신의 함수를 호출하는 것을 말한다. 재귀적인 함수를 사용할 때는 무한 루프에 빠질 수 있기 때문에 매우 주의를 요한다. 따라서 여러분은 재귀 호출을 끝내는 적절한 방법을 마련해 두어야 한다. 다음의 간단한 예제는 10번의 재귀적 호출을 한다. :

  1 
  2 Function Test () {
  3     static $a = 0;
  4     echo $a;
  5     $a++;
  6 }
  7     

가변 변수 (Variable variables)

가끔 변수의 이름을 변경할 수 있다면 편리하다고 느낄 때가 있다. 이곳에서는 변수의 이름을 바꾸어 사용하는 방법을 알아보자. 보통의 변수 선언은 다음과 같다. :

  1 
  2 $a = "hello";
  3     

여기서 이 가변 변수은 변수의 값을 가질 수도 있고, 또한 이 값을 변수의 이름으로 다룰 수도 있다. 위의 예에서 hello는 $$를 앞에 붙이면 변수 이름으로 사용할 수 있는 것이다. 예 :

  1 
  2 $$a = "world";
  3     

이렇게 하면 PHP의 symbol tree에는 "hello"라는 값을 가지는 $a와 "world"라는 값을 가지는 $hello의 두 개의 변수가 생기게 된다. 그러므로 다음과 같은 문장은 :

  1 
  2 echo "$a ${$a}";
  3     

다음 문장과 똑 같은 출력을 나타내게 된다.:

  1 
  2 echo "$a $hello";
  3     

ie. 둘의 출력: hello world.

가변 변수를 배열과 함께 사용하려면, 한가지 모호성 문제를 해결해야 한다. 그것은, 만약 여러분이 $$a[1]이라고 썼으면, $a[1]을 하나의 변수로 볼 것인지, 아니면 $$a를 변수로 보고 그 변수에 [1]의 인덱스를 해 줄 것인가 하는 문제이다. 다음과 같이 하여 모호성을 해결하자. 전자의 경우 ${$a[1]}라고 쓰고, 후자의 경우는 ${$a}[1]라고 쓰면 된다. ( 역자주: 가변 변수를 나타낼 때는 항상 { }로 둘러 싸는 것이 보기 좋고 오류도 없앨 수 있다.)

PHP 밖에서 온 변수들 (Variables from outside PHP)

HTML Forms (GET and POST)

폼이 PHP 스크립트로 submit되면 폼에 있는 모든 내용들이 자동적으로 만들어진 PHP 변수로 들어온다. 다음의 폼을 보자 :

Example 7-1. Simple form variable 1  2 <form action="foo.php3" method="post"> 3  Name: <input type="text" name="name"><br> 4  <input type="submit"> 5 </form> 6

위의 폼이 submit되면 PHP는 $name변수를 만들고, 이 변수에 폼의 Name: 필드에 입력된 모든 내용을 저장한다.

PHP는 폼에 1차원 배열 변수도 사용할 수 있다. 예를들어, 여러분은 여러 변수를 함께 사용하는 그룹 관련 변수(group related variables)나 multi select 변수의 내용들을 검색할 수 있다. :

Example 7-2. More complex form variables 1  2 <form action="array.php" method="post"> 3  Name: <input type="text" name="personal[name]"><br> 4  Email: <input type="text" name="personal[email]"><br> 5  Beer: <br> 6  <select multiple name="beer[]"> 7  <option value="warthog">Warthog 8  <option value="guinness">Guinness 9  <option value="stuttgarter">Stuttgarter Schwabenbräu 10  </select> 11  <input type="submit"> 12 </form> 13

만약 track_vars 설정이 on 되어 있거나, <?php_track_vars?> 지시자가 설정되어 있다면, POST나 GET으로 전송되는 모든 변수들과 그 내용은 전역 배열 변수인 $HTTP_POST_VARS과 $HTTP_GET_VARS에서 찾을 수 있다.

IMAGE SUBMIT의 변수 이름

폼은 submit할 때 일반적으로 사용하는 submit 버튼대신 다음과 같이 그림을 사용할 수도 있다. :

  1 
  2 <input type=image src="image.gif" name="sub">

사용자가 image를 클릭하면, 폼은 sub_x와 sub_y의 두 개의 변수가 추가되어 서버에 전송된다. 이 두 변수는 이미지에서 사용자가 click한 위치 정보를 담고 있다. 일부 브라우저에서는 밑줄(_)대신 마침표(.)를 사용하는 경우도 있는데, PHP는 이런 경우 자동적을 마침표(.)를 밑줄(_)로 바꿔준다.

HTTP Cookies

PHP는 HTTP 쿠키를 Netscape's Spec의 정의에 따라 제공한다. Cookie 메카니즘은 트래킹이나 사용자 식별 등을 위해 원격 browser에 저장된 데이터를 돌려 받는 과정을 말한다. 여러분은 cookie를 설정하기 위해 SetCookie() 함수를 사용할 수 있다. Cookie는 HTTP 헤더의 한 부분이므로, SetCookie() 함수는 브라우저로 보내는 어떤 데이터보다도 앞에 사용해야 한다. 이 제약은 Header() 함수와 같은 제약으로 보면 된다. 당신이 보내준 모든 cookie는 자동적으로 GET이나 POST 방식 데이터와 같은 PHP 변수로 변환된다.

만약 여러분이 동일한 cookie에 여러 값을 저장하고 싶다면 Cookie이름에 []를 더하면 된다. 예를 들어 :

  1 
  2 SetCookie ("MyCookie[]", "Testing", time()+3600);
  3      

쿠키는 새로 설정하면 path나 도메인이 다르지 않는 한 이전의 쿠키를 덮어쓰게 된다. 그러므로 쇼핑 카트 같은 응용 프로그램에서는 카운터를 유지하고, 이것을 기준으로 Cookie를 사용하는 것이 좋다. 예 :

Example 7-3. SetCookie Example 1  2 $Count++; 3 SetCookie ("Count", $Count, time()+3600); 4 SetCookie ("Cart[$Count]", $item, time()+3600); 5

환경 변수 (Environment variables)

PHP는 자동적으로 환경 변수들을 일반적인 PHP 변수로 만든다.

  1 
  2 echo $HOME;  /* Shows the HOME environment variable, if set. */
  3       

GET, POST and Cookie 메카니즘을 통해서 정보가 들어 온 정보로부터 자동적으로 PHP 변수가 생기므로, 이 방법은 때때로 올바른 버전을 확인하기 위해 환경으로부터 변수를 읽어 들이기에 가장 좋다. 이를 위해 getenv() 함수를 사용할 수도 있다. 여러분은 환경 변수를 설정하기 위해 putenv() 함수를 사용할 수도 있다.

위의 경우 파서는 $varname이라는 변수와, 연결 연산자, 'ext'(따옴표가 없는 경우 그것이 어떤 알려진 키나 예약어가 아니면 문자열로 취급된다.)로 해석한다. 따라서 이것은 우리가 원하는 결과가 아니다.

위와 같은 이유로 PHP는 외부에서 불러들인 변수의 이름에 '.'이 있으면 '_'(밑줄)로 바꾸어 읽어들인다.

변수의 Type 판단 (Determining variable types)

PHP가 변수의 type을 정하고 (일반적으로) 필요한 경우에는 그 type을 바꾸므로, 특정 시점에 그 변수 어떤 type인지는 쉽게 알 수 없다. PHP는 변수의 type을 알아보기 위해 여러개의 함수를 가지고 있다. gettype(), is_long(), is_double(), is_string(), is_array(), and is_object()가 그것들이다.

Chapter 8. 상수(Constants)

PHP는 약간의 기본적인 상수들을 제공하고, 실행시 상수를 설정할 수 있는 메카니즘을 지원한다. 상수는 변수와 비슷하다. 그러나 define()함수를 사용하여 선언한다는 것과 나중에 다른 값으로 바꿀 수 없다는 점이 차이가 있다.

미리 지정된 상수는 다음과 같다.

__FILE__

현재 처리중인 스크립트의 파일명. 현재 파일이 include나 require로 포함된 파일이라면, include함수등을 호출한 부모 파일이 아닌, 포함된 파일의 이름을 가진다.

 

__LINE__

현재 처리중인 명령의 스크립트내에서의 라인 번호. 현재 파일이 include나 require로 포함된 파일이라면, include함수등을 호출한 부모 파일이 아닌, 포함된 파일내에서의 라인 번호를 가진다.

 

PHP_VERSION

현재 사용중인 PHP 파서의 버전. (예 : '3.0.8-dev')

 

PHP_OS

PHP 파서가 실행되고 있응 OS의 이름. (예 : 'Linux')

 

TRUE

참(TRUE) 값

 

FALSE

거짓(FALSE) 값

 

E_ERROR

문법 오류가 아닌 복구가 불가능한 에러를 표시한다.

 

E_WARNING

PHP가 어떤 계속 수행 가능한 오류를 감지 했음을 표시한다. 예를들어 ereg()에 regexp가 잘못된 경우 등이다.

 

E_PARSE

파서가 스크립트 파일에서 문법적으로 잘못된 명령을 만난 경우이다. 복구는 불가능하다.

 

E_NOTICE

에러는 아니지만 어떤 알려질 사항이 있음을 나타낸다. 실행은 계속된다. 예를들어 hash 인덱스에 따옴표가 없는 문자열이 사용되었다던지, 이전에 선언되지 않은 변수의 값을 읽는다던지 하는 경우이다.

E_* 상수는 대개 error_reporting() 함수를 사용하여 reporting 레벨을 정할 때 흔히 사용된다.

또한 여러분은 define()함수를 사용하여 추가적인 상수를 정의할 수 있다.

주의할 점은 상수는 C에서의 macro 값은 것이 아니다. 단지 scalar 값을 가질 수 있을 뿐이다.

  1 
  2 <?php
  3 define("CONSTANT", "Hello world.");
  4 echo CONSTANT; // outputs "Hello world."
  5 ?>
  6      

  1 
  2 <?php
  3 function report_error($file, $line, $message) {
  4     echo "An error occured in $file on line $line: $message.";
  5 }
  6 
  7 report_error(__FILE__,__LINE__, "Something went wrong!");
  8 ?>
  9      

Chapter 9. 표현식 (Expressions)

표현식은 PHP에서 매우 중요한 내용이다. PHP에서 여러분이 작성하는 거의 모든 것은 표현식이다. 간단히 표현식의 정의를 엄밀하게 말한다면 "값을 가지고 있는 모든 것"("anything that has a value")이다.

간단한 예제로 "$a = 5"와 같은 것이 있다. 이것은 5라는 값을 $a라는 변수에 대입하는 문장이다. 여기서 5라는 표현식은 5의 값이라는 의미가 된다. 위의 문장 다음에 "$b = $a"라는 문장이 있다면 여기서 $a라는 표현식은 그 변수가 가진 5라는 값을 표현한다.

조금 복잡한 경우는 함수이다. 다음 함수를 보자. :

  1 
  2 function foo () {
  3     return 5;
  4 }
  5      

$c = 5라는 문장에서 foo()는 5를 돌려줄 것이기 때문에 'foo()'라는 표현식은 5를 표현한다고 말할 수 있다.

PHP는 정수값(integer values), 실수값(floating point values), 문자열(string values)의 3가지 스칼라 type을 가지고 있다. (스칼라 값이란 더 이상 작은 값으로 쪼개질 수 없는 값을 말한다.) 또한 PHP는 배열(array)과 객체(object)의 2가지 혼합(composite, non-scalar) type을 지원한다. 이 type들은 변수에 값을 할당할 수 있고, 함수에 의해 값을 돌려줄 수 있다.

여기까지는 PHP/FI 2 사용자들은 아무것도 바뀌지 않았다고 느낄 것이다. PHP는 거의 모든 것이 표현식으로 표현된다는 점에서, 표현 중심 언어 (expression-oriented language)라고 불릴 수 있다. 표현 중심의 좋은 예는 대입문이다. PHP에서는 C와 같이 대입문도 하나의 표현식으로 본다. 따라서 '$a=5; $b=5;'는 '$a = ($b=5);' 혹은 '$a = $b = 5;'로 표현 가능하다.

표현 중심의 다른 좋은 예로는 ++와 --이다. In PHP/FI 2에서는 '$a++'와 같은 문장은 아무 값도 가지지 않았다. 즉, 표현식이 아니었다. 따라서 이 값을 다른 곳에 대입하는 것은 불가능했다. 그러나 PHP 3에서는 이것이 가능해졌다. C에서와 같이 ++/--를 사용하는 방법에는 앞에 붙이는 것과 뒤에 붙이는 것 두가지가 있다. 둘 모두 변수의 값이 증가된다는 점은 같으나, '++$variable'은 그 변수의 증가된 값이 표현식의 값이 되고, '$variable++'는 변수의 증가되기 전의 값이 표현식의 값이 된다.

비교 표현식은 0이나 1의 값을 가진다. 0은 부정(FALSE)을 1은 긍정(TRUE)를 나타낸다. PHP는 > (bigger than), >= (bigger than or equal to), == (equal),< (smaller than), <= (smaller than or equal to)를 지원한다.

마지막 예는 결합된 연산-대입 표현식(combined operator-assignment expression)이다. 뭐 복잡한 얘기는 아니고 '$a = $a + 3'은 표현식을 '$a += 3'으로 표현할 수 있는 것이다. -=, *=, /=, .= 등도 사용할 수 있다.

다음예를 보면 도움이 될 것이다. :

  1 
  2 function double($i) {
  3     return $i*2;
  4 }
  5 $b = $a = 5;          /* $a와 $b 에 5 대입 */
  6 $c = $a++;            /* post-increment, $c 에는 $a의 원래 값인 5가 대입되고 $a는 6이 된다 */
  7 $e = $d = ++$b;       /* pre-increment, $d와 $e는 증가된 $b의 값 6이 대입된다. */
  8  
  9 /* 여기부터 $d와 $e의 값은 6이다. */
 10 $f = double($d++);    /* $f는 $d가 증가되기 전의 값인 6을 두 배한 값을 가진다. 2*6 = 12 */
 11 $g = double($++e);    /* $g는 $e가 증가된 후의 값인 7을 두배한값을 가진다. 2*7 = 14 */
 12 $h = $g += 10;        /* $g는 14에 10을 더해 24의 값을 가진 후 그 값을 $h에 대입한다. 둘다 24 */
 13 

그러나, 하나의 표현식이 하나의 문장은 아니다. 표현식이 세미콜론 ';'으로 끝나야 하나의 문장이 되는 것이다. 즉 '$b=$a=5;'에서 $a=5는 표현식이지만 문장은 아니다.

PHP에서 참/거짓의 판단은 Perl과 비슷하다. 0이 아닌 숫자는 모두 TRUE이고, 0은 FALSE이다. 빈 문자열이나 문자열 "0"은 FALSE이다. 다른 모든 문자열은 TRUE이다. 배열이나 객체는 원소가 하나도 없다면 FALSE를 의미하고, 나머지의 경우는 TRUE이다.

앞으로 이 매뉴얼에서 'expr'이라고 쓰여진 부분은 PHP의 올바른 표현식이라는 의미이다.

Chapter 10. 연산자 (Operators)

산술 연산자 (Arithmetic Operators)

학교에서 배운 산술 연산(가감승제)을 기억하는가? 이 산술 연산자는 그것들처럼 동작한다.

Table 10-1. Arithmetic Operators

예	이름	결과
$a + $b	덧셈(Addition)	$a와 $b의 합.
$a - $b	뺄셈(Subtraction)	$a에서 $b를 뺀 값.
$a * $b	곱셈(Multiplication)	$a와 $b의 곱.
$a / $b	나눗셈(Division)	$a에서 $b를 나눈 값(혹 은 몫).
$a % $b	나머지(Modulus)	$a에서 $b를 나눈 나머지.

대입 연산자 (Assignment Operators)

기본 대입 연산자는 "="이다. 이 연산자를 처음 보았을 때는 "같다"라는 연산자로 생각하기 쉽지만 전혀 아니다. 이것의 의미는 오른쪽의 표현식을 계산하여 그 값을 왼쪽에 있는 피연산자의 값으로 설정한다는 의미이다. (이것을 "gets set to"라고 한다.)

대입 연산자의 값은 왼쪽으로 대입된 값이다. 즉, "$a = 3"의 값은 3이 된다. 이것은 여러분에게 약간의 트릭이 가능하도록한다.

  1 
  2 $a = ($b = 4) + 5; // $a는 9, $b는 4의 값을 가진다.
  3 

기본적인 대입 연산자 외에 모든 Bit 단위 연산자, 산술 연산자와 결합한 복합 대입 연산자도 있다. 결합된 연산자는 표현식에서 해당 연산으로 사용되고, 그 연산 값을 왼쪽에 있는 피연산자에 대입한다. 예를 들어 :

  1 
  2 $a = 3;
  3 $a += 5; // $a는 8이다. $a = $a + 5; 와 동일하다.
  4 $b = "Hello ";
  5 $b .= "There!"; // $b는 "Hello There!"가 된다. $b = $b . "There!";와 같다.
  6 

Bit 단위 연산자 (Bitwise Operators)

비트 단위 연산자는 정수의 개별 비트의 값을 on, off 할 수 있다.

Table 10-2. Bitwise Operators

example	name	result
$a & $b	And	$a와 $b가 모두 1인 비트만 1이 된다.
$a | $b	Or	$a와 $b중 하나라도 1인 비트는 1이 된다.
$a ^ $b	Xor	$a와 $b중 하나는 1이고, 다른 하나는 0인 비트만 1이되고, 나머지는 0이 된다.
~ $a	Not	$a에서 1인 비트는 0으로, 0인 비트는 1로 된다.
$a << $b	Shift left	$a의 비트들을 $b step 만큼 왼쪽으로 shift 한다. (한 step은 2를 한 번 곱하는 만큼의 효과가 있다.)
$a >> $b	Shift right	$a의 비트들을 $b step 만큼 오른으로 shift 한다. (한 step은 2를 한 번 나누는 만큼의 효과가 있다.)

비교 연산자 (Comparison Operators)

비교 연산자는 이름에서 알 수 있듯이 두 개의 값을 비교하는 연산자이다.

Table 10-4. Comparson Operators

example	name	result
$a == $b	Equal	$a와 $b가 같으면 true.
$a === $b	Identical	$a와 $b가 같으면 true. $a와 $b의 type까지 동일해야 한다. (PHP4 only)
$a != $b	Not equal	$a와 $b가 다르면 true.
$a < $b	Less than	$a가 $b보다 작으면 true.
$a > $b	Greater than	$a가 $b보다 크면 true.
$a <= $b	Less than or equal to	$a가 $b보다 작거나 같으면 true.
$a >= $b	Greater than or equal to	$a가 $b보다 크거나 같으면 true.

또다른 조건 연산자로 C나 다른 언어에 있는 "?:" 연산자가 있다.

  1 
  2 (expr1) ? (expr2) : (expr3);
  3 

이 표현식은 expr1의 결과가  참여면 expr2를 반환하고, 거짓이면 expr3를 반환한다.

오류 제어 연산자 (Error control Operators)

PHP는 @(at 표시)이라는 한 개의 오류 제어 연산자를 제공한다. PHP의 표현식 앞에 이 표시가 붙으면, 해당 표현식에서 발생한 모든 에러 메시지가 무시된다.

만약 track_errors 기능이 활성화 되어 있다면, 해당 표현식에서 발생한 모든 에러 메시지는 $php_errormsg 라는 전역 변수에 저장될 것이다. 이 변수의 값은 매번 에러가 발생할 때마다 새로 설정된다. 따라서 만약 여러분이 이 변수를 사용하려면 에러가 발생한 직후에 최대한 빨리 사용하여야 한다.

  1 
  2 <?php
  3 /* Intentional SQL error (extra quote): */
  4 $res = @mysql_query( "select name, code from 'namelist" ) or
  5    die( "Query failed: error was '$php_errormsg'" );
  6 ?>
  7      

See also error_reporting().

실행 연산자 (Execution Operators)

  1 
  2 $output = `ls -al`;
  3 echo "<pre>$output</pre>";
  4 	 

  1 
  2 <?php
  3 echo "<h3>Postincrement</h3>";
  4 $a = 5;
  5 echo "Should be 5: " . $a++ . "<br>\n";
  6 echo "Should be 6: " . $a . "<br>\n";
  7 
  8 echo "<h3>Preincrement</h3>";
  9 $a = 5;
 10 echo "Should be 6: " . ++$a . "<br>\n";
 11 echo "Should be 6: " . $a . "<br>\n";
 12 
 13 echo "<h3>Postdecrement</h3>";
 14 $a = 5;
 15 echo "Should be 5: " . $a-- . "<br>\n";
 16 echo "Should be 4: " . $a . "<br>\n";
 17 
 18 echo "<h3>Predecrement</h3>";
 19 $a = 5;
 20 echo "Should be 4: " . --$a . "<br>\n";
 21 echo "Should be 4: " . $a . "<br>\n";
 22 ?>	  
 23 	 

Logical Operators

Table 10-3. Logical Operators

example	name	result
$a and $b	And	$a와 $b가 모두 true 이면 true
$a or $b	Or	$a와 $b중 하나라도 true이면 true
$a xor $b	Xor	$a와 $b중 하나만 true이어야 true
! $a	Not	$a가 true가 아니면 true
$a && $b	And	$a와 $b가 모두 true 이면 true
$a || $b	Or	$a와 $b중 하나라도 true이면 true

"and"와 "or" 연산자가 두가지의 다른 형태를 가지고 있는 이유는 이 연산자들이 서로 다른 우선순위를 가지고 있기 때문이다. (아래를 보라.)

연산자 우선 순위 (Precedence)

연산자들의 우선순위는 두 개의 표현식중 어느것이 더 단단히 묶여 있는가를 명기한다. 예를들어 1 + 5 * 3은 16을 반환하지 18을 반환하지 않는다. 왜냐하면 곱하기("*")연산자가 더하기("+")연산자보다 우선순위가 높기 때문이다.

다음 표는 연산자의 우선순위를 나타낸다 가장 위에 있는 연산자의 우선순위가 가장 낮다.

문자열 연산자 (String Operators)

문자열 연산자에는 두개가 있다. 첫 번째는 오니쪽과 오른쪽의 두 문자열을 연결하는 연결(concatenation) 연산자 (".") 가 있다. 두 번쨰로는 연결 대입 연산자 (".=") 가 있다. 이에 대해서는 대입연산자(Assugnment Operator) 부분을 읽어보자.

  1 
  2 $a = "Hello ";
  3 $b = $a . "World!"; // now $b contains "Hello World!"
  4 
  5 $a = "Hello ";
  6 $a .= "World!"; // now $a contains "Hello World!"
  7      

$a = "Hello ";
$b = $a . "World!"; // now $b = "Hello World!"

Chapter 11. 제어 구조 (Control Structures)

모든 PHP 스크립트는 일련의 구문으로 이루어 진다. 하나의 구문은 대입문이 될 수도 있고, 함수 호출, 반복문, 조건문이 될 수도 있으며 심지어는 아무 내용이 없는 빈 문장일 수도 있다. 한 구문은 일반적으로 세미콜론(;)으로 끝난다. 또한 여러개의 구문을 중괄호({,})를 사용하여 하나의 그룹으로 만들어 사용할 수도 있다. 이 구문-그룹은 그 그룹의 모든 구문들이 하나의 구문인 것처럼 인식된다. 여기서는 여러 가지 구문형태에 대해 알아본다.

if

PHP의 IF문은 C와 비슷하다.

  1 
  2 if (expr)
  3     statement
  4      

expr을 평가하여 TRUE이면 statement를 실행한다. FALSE이면 무시한다.

다음 예제는 $a가 $b보다 크면 "a is bigger than b"를 출력한다.

  1 
  2 if ($a > $b)
  3     print "a is bigger than b";
  4      

여러 문장을 실행시키려면 중괄호( { } )를 사용하여 복문으로 만들면된다. :

  1 
  2 if ($a > $b) {
  3     print "a is bigger than b";
  4     $b = $a;
  5 }
  6      

else

ELSE는 IF문의 평가식이 FALSE일 경우 실행하는 문장을 지정한다. :

  1 
  2 if ($a > $b) {
  3     print "a is bigger than b";
  4 } else {
  5     print "a is NOT bigger than b";
  6 }
  7      

elseif

ELSEIF는 ELSE와 IF를 합쳐놓은 것과 같다. :

  1 
  2 if ($a > $b) {
  3     print "a is bigger than b";
  4 } elseif ($a == $b) {
  5     print "a is equal to b";
  6 } else {
  7     print "a is smaller than b";
  8 }
  9      

한 IF문에는 여러개의 ELSEIF문이 있을 수 있다. ELSEIF문은 순서대로 평가하여 TRUE인 곳을 실행한다. 즉, 어떤 ELSEIF문이 실행 되려면 IF문의 평가식과 그 앞의 모든 ELSEIF문의 평가식이 FALSE이어야 한다. 이것은 'else if'라고 두 개의 문장으로 써도 된다(문법적인 의미는 약간 다르지만).

제어구조의 다른 표현 (Alternative syntax for control structures)

PHP 3는 중괄호({ })를 쓰는 대신 IF(expr)뒤에 콜론( : )을 찍고, 하나 이상의 문장을 나열한 후에 ENDIF;로 끝내는 방법을 제공한다. 이 방법은 특히 IF문 안에 HTML 블럭을 삽입하는데 유용하게 사용될 수 있다. 다음 예를 보자. :

  1 
  2  <?php if ($a == 5): ?>
  3  A is equal to 5
  4  <?php endif; ?>
  5      

위의 예에서 "A = 5"라는 HTML 블록이 IF문 안에 사용되고 있다. 위의 HTML 블록은 $a가 5일 경우에만 표시된다.

다음과 같이 ELSE와 ELSEIF (expr)도 사용할 수 있다. :

  1 
  2 if ($a == 5):
  3     print "a equals 5";
  4     print "...";
  5 elseif ($a == 6):
  6     print "a equals 6";
  7     print "!!!";
  8 else:
  9     print "a is neither 5 nor 6";
 10 endif;
 11      

while

WHILE 루프는 PHP 3의 가장 간단한 형태이다. 이것은 C와 동일하게 작동한다. 기본 형태는 다음과 같다. :

  1 
  2 while (expr) statement
  3      

IF문과 마찬가지로 다음과 같은 문장 형태로 중괄호( { } )를 사용하지 않는 방법도 있다. :.

  1 
  2 while (expr): statement ... endwhile;
  3      

다음두개의 예제는 동일한 예제이다. 1부터 10까지 출력한다.:

  1 
  2 /* example 1 */
  3 
  4 $i = 1;
  5 while ($i <= 10) {
  6     print $i++;  /* the printed value would be
  7                     $i before the increment
  8                     (post-increment) */
  9 }
 10  
 11 /* example 2 */
 12  
 13 $i = 1;
 14 while ($i <= 10):
 15     print $i;
 16     $i++;
 17 endwhile;
 18      

do..while

DO..WHILE 루프는 비교식이 앞이 아닌 맨 뒤에 있다는 점을 제외하면 WHILE 루프와 비슷하다. 따라서 WHILE 조건절은 DO 문장이 실행된 후에 평가되므로, DO 이후의 문장은 무조건 한번은 실행된다.

다음과 같은 DO..WHILE 루프에서도 한번은 출력이 된다. :

  1 
  2 $i = 0;
  3 do {
  4    print $i;
  5 } while ($i>0);
  6      

for

FOR는 PHP의 가장 복잡한 루프이다. 이것은 C와 유사하다. FOR 루프의 형태는 다음과 같다. :

  1 
  2 for (expr1; expr2; expr3) statement
  3      

첫 번째 표현식(expr1)은 루프를 시작할 때 무조건 한번 평가(실행)된다.

매 반복의 시작 때마다 expr2가 평가된다. 만약 이것이 TRUE면 루프는 계속되고 statement가 실행된다. expr2가 FALSE이면 루프는 종료된다.

매 반복이 끝날 때 expr3가 평가(실행)된다.

각 평가식은 비워둘 수 있다.expr2가 비어있으면 무한 루프를 뜻한다. (PHP는 C와 같이 비어있으면 TRUE로 인식한다.) 이건 별로 좋은 방법이 아니지만, 종종 BREAK를 사용하여 종료하는 방법도 있다.

다음 예는 1에서 10까지 출력하는 예이다. :

  1 
  2 /* example 1 */
  3  
  4 for ($i = 1; $i <= 10; $i++) {
  5     print $i;
  6 }
  7  
  8 /* example 2 */
  9  
 10 for ($i = 1;;$i++) {
 11     if ($i > 10) {
 12         break;
 13     }
 14     print $i;
 15 }
 16  
 17 /* example 3 */
 18  
 19 $i = 1;
 20 for (;;) {
 21     if ($i > 10) {
 22         break;
 23     }
 24     print $i;
 25     $i++;
 26 }
 27  
 28 /* example 4 */
 29  
 30 for ($i = 1; $i <= 10; print $i, $i++) ;
 31      

물론 처음것이 가장 좋아보인다. 그러나 나머지도 가능하다는 것을 알아야 한다.

PHP는 FOR 루프에 대해서도 다음과 같은 "colon syntax"를 지원한다.

  1 
  2 for (expr1; expr2; expr3): statement; ...; endfor;
  3      

일부 다른 언어들은 배열을 탐색하기 위하여 foreach 문장을 제공하기도 한다. 그러나 PHP는 이를 위해 list()와 each() 함수를 사용하여 while 루프로 해결한다. 이 함수들에 대해서는 예제를 참조하자.

  1 
  2 foreach(array_expression as $value) statement
  3 foreach(array_expression as $key => $value) statement
  4      

  1 
  2 reset ($arr);
  3 while (list(, $value) = each ($arr)) {
  4     echo "Value: $value<br>\n";
  5 }
  6 
  7 foreach ($arr as $value) {
  8     echo "Value: $value<br>\n";
  9 }
 10      

다음 두 개의 문장은 기능적으로 동일한 문장이다. :

  1 
  2 reset ($arr);
  3 while (list($key, $value) = each ($arr)) {
  4     echo "Key: $key; Value: $value<br>\n";
  5 }
  6 
  7 foreach ($arr as $key => $value) {
  8     echo "Key: $key; Value: $value<br>\n";
  9 }
 10      

  1 
  2 /* foreach example 1: value only */
  3 
  4 $a = array (1, 2, 3, 17);
  5 
  6 foreach ($a as $v) {
  7    print "Current value of \$a: $v.\n";
  8 }
  9 
 10 /* foreach example 2: value (with key printed for illustration) */
 11 
 12 $a = array (1, 2, 3, 17);
 13 
 14 $i = 0; /* for illustrative purposes only */
 15 
 16 foreach($a as $v) {
 17     print "\$a[$i] => $k.\n";
 18 }
 19 
 20 /* foreach example 3: key and value */
 21 
 22 $a = array (
 23     "one" => 1,
 24     "two" => 2,
 25     "three" => 3,
 26     "seventeen" => 17
 27 );
 28 
 29 foreach($a as $k => $v) {
 30     print "\$a[$k] => $v.\n";
 31 }
 32      

break

break는 현재 루프에서 빠져 나가는 명령이다.

break에는 숫자 옵션을 줄 수 있는데, 이것은 한번에 빠져 나갈 제어 구조의 수를 의미한다.

  1 
  2 $i = 0;
  3 while ($i < 10) {
  4     if ($arr[$i] == "stop") {
  5         break;  /* You could also write 'break 1;' here. */
  6     }
  7     $i++;
  8 }
  9 
 10 /* Using the optional argument. */
 11 
 12 $i = 0;
 13 while ( ++$i ) {
 14     switch ( $i ) {
 15     case 5:
 16         echo "At 5<br>\n";
 17         break 1;  /* Exit only the switch. */
 18     case 10:
 19         echo "At 10; quitting<br>\n";
 20         break 2;  /* Exit the switch and the while. */
 21     default:
 22         break;
 23     }
 24 }
 25      

continue

CONTINUE 는 현재 루프의 처음으로 가도록 하는 명령이다.

continue도 숫자 옵션을 줄 수 있는데, 이것은 한번에 처음으로 갈 제어 구조의 수를 의미한다.

  1 
  2 while (list ($key, $value) = each ($arr)) {
  3    if (!($key % 2)) { // skip odd members
  4        continue;
  5    }
  6    do_something_odd ($value);
  7 }
  8 
  9 $i = 0;
 10 while ($i++ < 5) {
 11     echo "Outer<br>\n";
 12     while (1) {
 13         echo "  Middle<br>\n";
 14         while (1) {
 15              echo "  Inner<br>\n";
 16              continue 3;
 17         }
 18         echo "This never gets output.<br>\n";
 19     }
 20     echo "Neither does this.<br>\n";
 21 }
 22      

switch

SWITCH문은 동일한 표현식의 IF문의 나열과 비슷하다. 다음 예는 동일한 것은 IF문과 SWITCH문으로 표현한 것이다. :

  1 
  2 if ($i == 0) {
  3     print "i equals 0";
  4 }
  5 if ($i == 1) {
  6     print "i equals 1";
  7 }
  8 if ($i == 2) {
  9     print "i equals 2";
 10 }
 11  
 12 switch ($i) {
 13     case 0:
 14         print "i equals 0";
 15         break;
 16     case 1:
 17         print "i equals 1";
 18         break;
 19     case 2:
 20         print "i equals 2";
 21         break;
 22 }
 23      

SWITCH문은 문장 단위로 실행된다. SWITCH에 있는 평가식과 일치하는 CASE문을 찾아 그 이후 SWITCH블럭이 끝날 때 까지 실행한다. 따라서 원하는 경우 BREAK로 실행을 중지시킬 필요가 있다. 다음 예를 보자. :

  1 
  2 switch ($i) {
  3     case 0:
  4         print "i equals 0";
  5     case 1:
  6         print "i equals 1";
  7     case 2:
  8         print "i equals 2";
  9 }
 10      

여기서 $i가 0이면 모든 print문을 실행할 것이다. 만약 $i가 1이면 마지막 두개의 print문을 실행한다. 따라서 여러분이 원하는 결과를 얻으려면 BREAK문을 잊지 않는 것이 중요한다.

특별한 case로 default case가 있다. 이 것은 다른 어떤 case에도 맞지 않는 경우를 의미한다. 예를 들어 :

  1 
  2 switch ($i) {
  3     case 0:
  4         print "i equals 0";
  5         break;
  6     case 1:
  7         print "i equals 1";
  8         break;
  9     case 2:
 10         print "i equals 2";
 11         break;
 12     default:
 13         print "i is not equal to 0, 1 or 2";
 14 }
 15      

다른 중요한 점은 CASE 표현식에는 정수, 실수, 문자열의 스칼리 타입으로 평가되는 어떤 표현식이와도 된다는 것이다. 배열이나 객체도 문제를 일으키지는 않는다. 그러나 그것은 문장에서 의미가 없다.

switch 문에 대해서도 Alternative syntax가 지원된다. 자세한 내용은 Alternative syntax for control structures 를 살펴보자

  1 
  2 switch ($i):
  3     case 0:
  4         print "i equals 0";
  5         break;
  6     case 1:
  7         print "i equals 1";
  8         break;
  9     case 2:
 10         print "i equals 2";
 11         break;
 12     default:
 13         print "i is not equal to 0, 1 or 2";
 14 endswitch;
 15      

require

require() 문은 C preprocessor의 #include와 비슷하게, 자신을 지정된 파일로 대체한다.

include() 되거나 require() 되어 읽혀지는 파일은 포함된 파일의 처음에 PHP모드에서 빠져나와 HTML모드로 들어가고, 마지막에 PHP모드로 복귀한다. 따라서 포함될 파일의 PHP 코드는 적절한 PHP 시작, 종료 택에 둘러싸여 있어야 한다.

이것은 require()문을 루프 구조 안에 두어, 매번 다른 파일을 읽어들일 수 없다는 것을 의미한다. 이런 동작을 위해서는 INCLUDE 문을 사용하라.

require('header.inc');

require()는 사실 함수가 아니라 제어구조이다. 따라서 이것은 함수와는 다른 규칙을 따른다. 이를테면 require()는 다른 어떤 제어구조와도 사용할 수 없다. 또한, 이것은 반환값이 없다. (반환값을 돌려받으려하면 파싱 에러가 난다.)

include()와 다르게, require()는 언제나 해당 파일을 읽어온다. 심지어 해당 라인이 전혀 실행되지 않아도 읽어온다. 만약 여러분이 조건에 따라 파일을 포함시키고 싶다면 include()문을 사용하여야 한다. 조건절은 require()에 아무 영향을 미치지 못한다. 그러나, require()문이 있는 줄이 실행되지 않는다면 해당 파일의 어떤 코드도 실행되지 않는다.

비슷하게, 순환문 또한 require()에 영향을 주지 못한다. 해당 파일에 있는 내용이 루프의 내용이라 하더러도 require()문은 단지 한번만 나타나는 것으로 된다.

이것은 require() 문을 순환문 안에 사용할 수 없다는 것을 의미하고, 매 순환시마다 다른 파일을 읽어오려면 include()문을 사용하여야 한다는 것이다.

  1 
  2 require ('header.inc');
  3      

include()와 require() 모두 호출한 스크립트안으로 원하는 파일의 내용 자체를 끌어들이는(pull) 것이지, HTTP나 그와 비슷한 방식으로 해당 타겟을 call하는 것은 아니다. 따라서 현재 범위안에 선언된 모든 변수들은 포함할 파일 안에서도 그대로 사용된다.

  1 
  2 require ("file.inc?varone=1&vartwo=2"); /* Won't work. */
  3 
  4 $varone = 1;
  5 $vartwo = 2;
  6 require ("file.inc");  /* $varone and $vartwo will be available in file.inc */
  7      

여러분은 remote files 기능을 사용하여 HTTP를 통한 원격 파일을 include하거나 require할 때 위의 내용을 명확히 알아둘 필요가 있다.

PHP3에서는 require()로 포함된 파일안에서 return 문을 사용할 수 있었다. 단, return 문이 포함된 파일의 global scope에서 나타나는 경우만 가능하고, 어떠한 블록내({} 내부)에서도 사용할 수 없다. 그러나, PHP4에서는 이런 기능 자체가 없어져 버렸다. 만약 여러분이 이런 기능을 사용하고 싶다면 include() 문을 사용하기 바란다.

include

INCLUDE문은 지정한 파일을 읽고 실행한다.

include() 되거나 require() 되어 읽혀지는 파일은 포함된 파일의 처음에 PHP모드에서 빠져나와 HTML모드로 들어가고, 마지막에 PHP모드로 복귀한다. 따라서 포함될 파일의 PHP 코드는 적절한 PHP 시작, 종료 택에 둘러싸여 있어야 한다.

이 동작은 실행중 include() 문을 만날 때 만다 일어난다. 따라서 여러분은 include() 문을 루프 구조 안에 두어 매번 다른 파일을 읽어 들이도록 할 수 있다.

  1 
  2 $files = array ('first.inc', 'second.inc', 'third.inc');
  3 for ($i = 0; $i < count($files); $i++) {
  4     include $files[$i];
  5 }
  6      

include()는 이 문장을 만날 때 마다 매번 재평가되어 재실행된다는 점에서 require()와 다르다. 반면에 require()문은 지정된 파일의 내용이 실행되는가에 관계없이(예를들어 if 문 안에 들어있고 상태가 거짓인 경우에도), 이 문장을 처음 만날을 때 지정된 파일로 대체된다.

include()는 특별한 구조이므로, 만약 이것이 조전절 안에 놓여있다면 반드시 {}(statement block)으로 둘러싸야 한다.

  1 
  2 /* This is WRONG and will not work as desired. */
  3  
  4 if ($condition)
  5     include($file);
  6 else
  7     include($other);
  8  
  9 /* This is CORRECT. */
 10  
 11 if ($condition) {
 12     include($file);
 13 } else {
 14     include($other);
 15 }
 16      

PHP3, PHP4 모두 include() 된 파일 내에서, 이 파일의 수행을 종료하고, 이 파일을 부른 스크립트로 복귀하기 위해 return 문을 사용할 수 있다. 약간 다른점이 있기는하다. 우선, PHP3에서는 해당 블록이 함수의 블록이 아닌한 return 문이 블록안에 올 수 없다. (함수의 블록 안에 있는 경우는 해당 함수에서 return 하는 것이지 현재 파일에서 return 하는 것은 아니다.) 그러나, PHP4에서는 이 제한이 없다. ㄸ또한 PHP4에서는 include() 파일의 return시에 리턴값을 사용할 수 있다. 여러분은 include() 문을 일반 함수처럼 반환값을 받을 수 있다. (이것은 PHP3에서는 구문에러를 발생시킨다.)

Before the return
File returned: '27'
     

Before the return 
27Back in main.html

Parse error: parse error in /home/torben/public_html/phptest/main.html on line 5
     

include()와 require() 모두 호출한 스크립트안으로 원하는 파일의 내용 자체를 끌어들이는(pull) 것이지, HTTP나 그와 비슷한 방식으로 해당 타겟을 call하는 것은 아니다. 따라서 현재 범위안에 선언된 모든 변수들은 포함할 파일 안에서도 그대로 사용된다.

  1 
  2 include ("file.inc?varone=1&vartwo=2"); /* Won't work. */
  3 
  4 $varone = 1;
  5 $vartwo = 2;
  6 include ("file.inc");  /* $varone and $vartwo will be available in file.inc */
  7      

여러분은 remote files 기능을 사용하여 HTTP를 통한 원격 파일을 include하거나 require할 때 위의 내용을 명확히 알아둘 필요가 있다.

See also readfile(), require(), virtual().

Chapter 12. Functions

User-defined functions

함수는 다음과 같이 정의한다. :

  1 
  2 function foo ($arg_1, $arg_2, ..., $arg_n) {
  3     echo "Example function.\n";
  4     return $retval;
  5 }
  6      

함수 안에는 다른 함수나 class의 선언 등을 포함한 모든 가능한 PHP 코드가 사용될 수 있다.

PHP3에서는 함수는 그 함수가 사용되기 이전에 선언되어 있어야 하였으나 PHP4에서는 이런 제약이 없어졌다.

PHP는 function overloading을 지원하지 않고, 이미 정의된 함수를 재정의하거나 없애지 못한다.

PHP3에서는 함수 파라메터의 기본값을 설정해주는 것(default argument values를 보자.)은 가능해도, 파라메터의 개수를 가변으로 설정하는 것은 불가능했지만, PHP4는 두가지 모두 가능하다. 자세한 내용은 Variable-length argument lists 와 func_num_args(), func_get_arg(), func_get_args() 의 함수 설명을 보기 바란다.

Function arguments

argument list를 통해 함수에 어떤 정보를 넘겨줄 수 있다. 이 argument list는 쉼표(,)로 나위어진 변수나 상수의 list이다.

PHP는 passing by value(기본적으로 이것을 사용)와 passing by reference, default argument values의 3가지 방법을 제공한다. 가변 길이(Variable-length) argument list는 PHP4이후에서만 제공된다. 자세한 내용은 Variable-length argument lists 와 func_num_args(), func_get_arg(), func_get_args() 의 함수 설명을 보기 바란다. 그러나 PHP3에서도 배열을 통한 전달을 사용한다면 비슷한 효과를 낼 수 있다.

  1 
  2 function takes_array($input) {
  3     echo "$input[0] + $input[1] = ", $input[0]+$input[1];
  4 }
  5      

Making arguments be passed by reference

기본적으로 함수의 인수(argument)들은 값으로 전달된다(passed by value). 함수내에서 변화시킨 값을 그대로 유지하려면 pass by reference로 인수를 넘겨야 한다.

여러분이 어떤 함수의 인수를 항상 pass by reference로 넘기려 한다면, 여러분은 함수를 선언할 때 ampersand(&)를 인수의 앞에 붙여주면 된다. :

  1 
  2 function add_some_extra(&$string) {
  3     $string .= 'and something extra.';
  4 }
  5 $str = 'This is a string, ';
  6 add_some_extra($str);
  7 echo $str;    // outputs 'This is a string, and something extra.'
  8       

만약 기본은 by value 로 하지만 필요에 따라 by reference로 호출하고 싶다면 함수 호출 시에 인수의 앞에 &를 붙이면 된다. :

  1 
  2 function foo ($bar) {
  3     $bar .= ' and something extra.';
  4 }
  5 $str = 'This is a string, ';
  6 foo ($str);
  7 echo $str;    // outputs 'This is a string, '
  8 foo (&$str);
  9 echo $str;    // outputs 'This is a string, and something extra.'
 10       

Default argument values

스칼라 인수는 다음과 같이 C++ 과 비슷하게 기본값을 정해줄 수 있다. :

  1 
  2 function makecoffee ($type = "cappucino") {
  3     return "Making a cup of $type.\n";
  4 }
  5 echo makecoffee ();
  6 echo makecoffee ("espresso");
  7       

위의 코드의 실행 결과는 다음과 같다 :

Making a cup of cappucino.
Making a cup of espresso.
     

default 값은 반드시 상수이어야 한다. (예를들어) 변수나 class의 멤버를 사용해서는 안된다.

PHP 4.0에서는 default argument로 unset을 지정할 수 있다. 이것은 해당 argument에 값이 제공되지 않으면, 절대로 값을 설정하지 않는 것을 의미한다.

default argument를 사용할 때, default가 되는 인수들은 non-default인 인수들보다 오른쪽에 위치해야 한다. 그렇지 않으면 원하는 결과가 나오지 않는다. 다음을 보자. :

  1 
  2 function makeyogurt ($type = "acidophilus", $flavour) {
  3     return "Making a bowl of $type $flavour.\n";
  4 }
  5  
  6 echo makeyogurt ("raspberry");   // won't work as expected
  7       

위 코드의 실행 결과는 다음과 같다 :

Warning: Missing argument 2 in call to makeyogurt() in 
/usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
Making a bowl of raspberry .
     

그러면 이제 위의 것과 아래것을 비교해 보자. :

  1 
  2 function makeyogurt ($flavour, $type = "acidophilus") {
  3     return "Making a bowl of $type $flavour.\n";
  4 }
  5  
  6 echo makeyogurt ("raspberry");   // works as expected
  7       

이 예제의 실행 결과는 다음과 같다. :

Making a bowl of acidophilus raspberry.
     

Returning values

함수는 return 문을 통해 함수값을 돌려줄 수 있다. list와 object를 포함한 어떤 type도 돌려질 수 있다.

  1 
  2 function square ($num) {
  3     return $num * $num;
  4 }
  5 echo square (4);   // outputs '16'.
  6      

여러값을 돌려주는 일은 할 수 없다. 그러나 list를 돌려줌으로써 비슷한 일을 할 수 있다. :

  1 
  2 function small_numbers() {
  3     return array (0, 1, 2);
  4 }
  5 list ($zero, $one, $two) = small_numbers();
  6      

old_function

OLD_FUNCTION 문장은 PHP/FI2에서 동일한 함수 사용법을 제공한다. (function대신 old_function을 사용한다는 점은 제외하고)

이것을 사용하는 것은 좋지 않은 방법이다. 이것이 사용될 때는 PHP/FI2->PHP3 변환기에서 뿐이다.

주의

OLD_FUNCTION으로 정의된 함수들은 PHP의 내부 코드에서 호출될 수 없다. 이 말은 usort()나 array_walk(), register_shutdown_function()같은 함수에 사용할 수 없다는 의미이다. 이를 해결하기 위해서는 이 OLD_FUNCTION으로 선언된 함수를 호출하는 PHP3 형태의 함수를 만들어 사용하는 것이다.

Chapter 13. Classes and Objects

( 역자주 : Class 문장은 Java의 subset이라 할만큼 동일하다. )

class

클래스는 일련의 변수와 이 변수들을 사용하는 함수들의 모음이다. 클래스는 다음과 같은 형태로 선언된다.

  1 
  2 <?php
  3 class Cart {
  4     var $items;  // Items in our shopping cart
  5    
  6     // Add $num articles of $artnr to the cart
  7  
  8     function add_item ($artnr, $num) {
  9         $this->items[$artnr] += $num;
 10     }
 11    
 12     // Take $num articles of $artnr out of the cart
 13  
 14     function remove_item ($artnr, $num) {
 15         if ($this->items[$artnr] > $num) {
 16             $this->items[$artnr] -= $num;
 17             return true;
 18         } else {
 19             return false;
 20         }   
 21     }
 22 }
 23 ?>
 24      

이 선언은 Cart라는 이름의 클래스로, 카트안에 들어있는 물품을 위한 한 개의 배열 변수와 cart에 물건을 넣거나 빼는 두 개의 함수로 구성되어 있다.

Classe는 Type으로, 실제 변수들의 청사진이라 할 수 있다. 여러분은 new 연산자를 사용하여 원하는 type의 변수를 생성하여야 한다.

  1 
  2  $cart = new Cart;
  3  $cart->add_item("10", 1);
  4     

위에 있는 예는 Cart 클래스의 $cart라는 object를 만드는 것이다. 이 object의 add_item() 함수를 호출하여 물품 번호 "10"번의 물품 1개를 카트에 넣는다.

클래스는 다른 클래스로 확장 될 수 있다. 확장 혹은 파생된(extended or derived) 클래스는 base 가 되는 클래스의 모든 변수들과 함수들을 그대로 가제게 되고, 여러분은 여기에 추가로 확장된 선언을 할 수 있다. 이를 위해 "extends"라는 키워드가 사용된다.

  1 
  2 class Named_Cart extends Cart {
  3     var $owner;
  4   
  5     function set_owner ($name) {
  6         $this->owner = $name;
  7     }
  8 }
  9     

위의 예는 Cart 클래스의 변수와 함수에 $owner 변수와 set_owner() 함수를 추가한 Named_Cart라는 클래스의 선언이다. 여러분은 이름붙은 카트(named cart)를 사용하여 카트의 주인을 설정하고 찾아볼 수 있다. 또한 기존의 일반 카트(normal cart)에 있던 함수도 사용할 수 있다.

  1 
  2 $ncart = new Named_Cart;    // Create a named cart
  3 $ncart->set_owner ("kris"); // Name that cart
  4 print $ncart->owner;        // print the cart owners name
  5 $ncart->add_item ("10", 1); // (inherited functionality from cart)
  6     

클래스 내부에 있는 함수에서 $this 라는 변수는 자기 자신 object를 의미한다. 여러분은 $this->something 의 형태로 현재 object의 변수나 함수를 사용하여야 한다.

생성자(Constructor)는 해당 클래스의 새 인스턴스(새로 만든 변수라고 생각해 두자)를 만들 때 자동적으로 실행되는 함수를 의미한다. 클래스의 이름과 같은 이름의 함수가 생성자가 된다.

  1 
  2 class Auto_Cart extends Cart {
  3     function Auto_Cart () {
  4         $this->add_item ("10", 1);
  5     }
  6 }
  7     

위의 예는 Cart 클래스에 물품번호 10번의 물품을 한 개 자동으로 추가하는 생성자를 추가한 Auto_Cart라는 클래스의 선언이다. Auto_Cart는 "new"로 생성된다. 생성자는 또한 인수(argument)를 가질 수 있고, 이 인수들은 default값을 가진 옵션으로 선언 할 수 있다. 이 기능은 매우 유용하게 사용된다.

  1 
  2 class Constructor_Cart extends Cart {
  3     function Constructor_Cart ($item = "10", $num = 1) {
  4         $this->add_item ($item, $num);
  5     }
  6 }
  7  
  8 // Shop the same old boring stuff.
  9  
 10 $default_cart   = new Constructor_Cart;
 11  
 12 // Shop for real...
 13  
 14 $different_cart = new Constructor_Cart ("20", 17);
 15     

III. 기능 (Features)

Table of Contents

14. Error handling

15. Creating GIF images

16. HTTP authentication with PHP

17. Cookies

18. Handling file uploads

19. Using remote files

20. Connection handling

21. Persistent database connections

Chapter 14. Error handling

PHP에는 다음과 같은 4가지의 에러와 경고 형태가 있다.

1 - Normal Function Errors (일반적인 에러)

2 - Normal Warnings (일반적인 경고)

4 - Parser Errors (문법 에러)

8 - Notices (무시할 수 있는 경고이나 버그의 가능성을 가지고 있는 경우)

error reporting level은 위의 4개의 숫자가 더해져서 결정된다. 기본 error reporting level 은 7로 1+2+4가 되고, 이는 Notice를 제외한 모든 것을 레포트하라는 의미이다. 이 레벨은 php3.ini 파일에서 error_reporting 지시자로 결정할 수 있다. 혹은, 아파치의 httpd.conf 파일에서 php3_error_reporting 지시자로 결정하거나, 스크립트 실행 중에 error_reporting() 함수를 사용하여 바꿔줄 수도 있다.

모든 PHP 표현식(expression)은 "@"를 앞에 붙이고 호출되면 error reporting을 하지 않는다. 만약 track_errors 기능이 Enabled로 되어 있는데 해당 문장에서 에러가 발생했다면, $php_errormsg라는 전역변수에서 에러 메시지를 찾을 수 있을 것이다.

Chapter 15. PHP에서 GIF의 생성 (Creating GIF images)

PHP는 단지 HTML출력을 만드는 것만 할 수 있는 것이 아니다. PHP는 GIF image file도 만들 수 있을 있을 뿐아니라, 사용하기에 편리한 GIF image stream까지 만들 수 있다. 이를 위해서 여러분은 PHP를 컴파일 할 때, image 함수를 가지고 있는 GD 라이브러리를 포함하여야 한다.

Example 15-1. GIF creation with PHP 1  2 <?php 3  Header("Content-type: image/gif"); 4  $string=implode($argv," "); 5  $im = imagecreatefromgif("images/button1.gif"); 6  $orange = ImageColorAllocate($im, 220, 210, 60); 7  $px = (imagesx($im)-7.5*strlen($string))/2; 8  ImageString($im,3,$px,9,$string,$orange); 9  ImageGif($im); 10  ImageDestroy($im); 11 ?> 12

위의 예제는 <img src="button.php3?text">와 같은 tag이 있는 페이지로부터 불려지게 될 것이다. 그러면 위에있는 button.php 스크립트는 "text"라는 문자열을 "images/button1.gif"에 오버레이 시켜 결과 image에 출력한다. 이렇게 하면 버튼에 들어가는 글씨를 매번 손쉽게 바꿔 쓸 수 있고, 또한 매번 이미지 파일을 만들 필요가 없어 효율적이고 간단하다.

Chapter 16. HTTP 인증 (HTTP authentication with PHP)

(역자주. HTTP authentication이란 Web Client에게 ID와 Password를 입력받아, 그 ID와 Password로 Web문서에 접근을 허가, 불허하는 기능을 말한다. 자세히 알고 싶다면 RFC1945의 Authentication 부분을 참고하기 바란다. http://pec.etri.re.kr/!qkim/HTTP/에 한글 번역 문서도 있으니 참조하자.)

PHP를 사용한 HTTP 인증은 Apache 모듈로 사용될 때만 동작한다. Apache 모듈의 PHP 스크립트에서 Header()라는 함수를 사용하면 Client 브라우저에게 Username과 Password를 입력받는 윈도우를 띄우도록 하는 "인증 요구"("Authentication Required") 메시지를 보내게 된다. 일단 사용자가 Username과 Password를 입력하면, user name, password, authentication type의 값을 가지는 $PHP_AUTH_USER, $PHP_AUTH_PW, $PHP_AUTH_TYPE의 3개의 변수를 가지고 해당 URL(PHP 스크립트를 포함한)이 다시 불리워진다. 현재 authentication type은 "Basic"만이 지원된다.

client authentication을 사용하여 그 입력된 값을 출력하는 예제가 아래에 있다. :

Example 16-1. HTTP Authentication example 1  2 <?php 3  if(!isset($PHP_AUTH_USER)) { 4  Header("WWW-Authenticate: Basic realm=\"My Realm\""); 5  Header("HTTP/1.0 401 Unauthorized"); 6  echo "Text to send if user hits Cancel button\n"; 7  exit; 8  } else { 9  echo "Hello $PHP_AUTH_USER.<P>"; 10  echo "You entered $PHP_AUTH_PW as your password.<P>"; 11  } 12 ?> 13

여러분은 $PHP_AUTH_USER 와 $PHP_AUTH_PW를 단순히 출력하는 대신, 사용자의 식별을 위해 username과 password를 사용하기를 원할 것이다. 이때는 Database에 Query하거나 직접 dbm 파일에서 찾아보면 가능할 것이다.

Internet Explorer browser에서는 버그로 인해 Header의 순서가 매우 까다롭다. WWW-authenticate header를 HTTP/1.0 401 header보다 먼저 보내는 것이 현재 가능한 요령으로 보인다.

비밀번호의 유출을 우려하여 HTTP에서 제공하는 인증을 사용하는 대신 기존의 외부 메카니즘을 사용할 경우에는 물론 PHP_AUTH 변수는 설정되지 않는다.

유의할 점은 인증이 필요한 페이지와 인증이 필요없는 페이지가 같은 서버상에 존재할 때, 인증이 필요없는 URL을 control할 수 있는 누군가가, 인증이 필요한 URL의 암호를 훔쳐보는 것은 막을 수 없다는 점이다.

Netscape와 Internet Explorer 모두 401응답 코드를 서버에서 받게되면 local browser window의 authentication cache를 clear한다. 즉, 이것은 "log out"개념이 되는 것으로, 사용자들로 하여금 username과 암호를 다시 입력하게 한다. 일부는 이것을 login의 "time out"이나 "log-out"버튼을 만드는데 사용한다

  1 
  2 <?php
  3   function  authenticate()  {
  4     Header( "WWW-authenticate:  basic  realm='Test  Authentication  System'");
  5     Header( "HTTP/1.0  401  Unauthorized");
  6     echo  "You  must  enter  a  valid  login  ID  and  password  to  access  this  resource\n";
  7     exit;
  8   }
  9 
 10   if(!isset($PHP_AUTH_USER)  ||  ($SeenBefore ==  1  &&  !strcmp($OldAuth,  $PHP_AUTH_USER))  )  {
 11     authenticate();
 12   }  
 13   else  {
 14     echo  "Welcome:  $PHP_AUTH_USER<BR>";
 15     echo  "Old:  $OldAuth";
 16     echo  "<FORM  ACTION=\"$PHP_SELF\"  METHOD=POST>\n";
 17     echo  "<INPUT  TYPE=HIDDEN  NAME=\"SeenBefore\"  VALUE=\"1\">\n";
 18     echo  "<INPUT  TYPE=HIDDEN  NAME=\"OldAuth\"  VALUE=\"$PHP_AUTH_USER\">\n";
 19     echo  "<INPUT  TYPE=Submit  VALUE=\"Re  Authenticate\">\n";
 20     echo  "</FORM>\n";
 21 
 22 }
 23 ?>
 24   

이 동작은 HTTP Basic authentication 기준에 요구되는 것은 아니므로 여러분은 이것에 의존하여서는 안된다. Lynx에서는 401 서버 응답을 받아도 authentication 정보를 clear하지 않는다. 따라서 Back을 누르고 다시 Forward 버튼을 눌러서 다시 접근할 수 있다.

또한 이 Authentication 기능은 Microsoft's IIS server에서 CGI version의 PHP를 사용할 경우에는 IIS의 제약으로인해 동작하지 않는다.

Chapter 17. Cookies

PHP는 HTTP Cookie를 투명하게(transparently) 지원한다. Cookie 메카니즘은 트래킹이나 사용자 식별 등을 위해 원격 browser에 저장된 데이터를 돌려 받는 과정을 말한다. 여러분은 cookie를 설정하기 위해 setcookie() 함수를 사용할 수 있다. Cookie는 HTTP 헤더의 한 부분이므로, SetCookie() 함수는 브라우저로 보내는 어떤 데이터보다도 앞에 사용해야 한다. 이 제약은 Header() 함수와 같은 제약으로 보면 된다.

당신이 보내준 모든 cookie는 자동적으로 GET이나 POST 방식 데이터와 같은 PHP 변수로 변환된다. 만약 여러분이 동일한 cookie에 여러 값을 저장하고 싶다면 Cookie이름에 []를 더하면 된다. 자세한 것은 setcookie() 함수 설명을 참조하자.

Chapter 18. Handling file uploads

POST method uploads

PHP는 RFC-1867을 지원하는 브라우저로부터 파일을 업로드 받을 수 있는 기능이 있다. 이 기능을 사용하면 Text분아니라 Binary파일도 업로드가 가능하다. 여러분은 PHP's authetication과 논리적인 함수들을 사용하여, Upload가 가능한 사용자와, 파일이 Upload된 후에 해야 할 일을 반드시 정해 두어야 한다. (역자주. RFC-1867은 Netscape 3.0이상, Explorer 4.0이상에서 지원한다. Netscape 2.x대의 일부 상위버젼도 지원하고, Explorer 3.02는 Patch가 나와 있으므로 patch시키면 가능하다.)

PHP는 또한 Netscape Composer 와 W3C's Amaya clients를 사용할 경우 PUT-method 의 파일 업로드도 지원한다. 자세한 내용은 PUT Method Support 를 읽어보기바란다.

파일 업로드 화면은 다음과 같은 좀 특별한 폼을 만들어 띄울 수 있다. :

  1 
  2 <FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD=POST>
  3 <INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000">
  4 Send this file: <INPUT NAME="userfile" TYPE="file">
  5 <INPUT TYPE="submit" VALUE="Send File">
  6 </FORM>
  7     

여기서_URL_은 PHP html파일이어야 합니다. hidden 필드인 MAX_FILE_SIZE는 File input 필드들보다 선행되어야 합니다. 이 값은 PHP html이 받아들이는 최대 파일 크기를 Byte단위로 나타냅니다. 업로드가 성공적으로 되면 지정된 파일에는 다음과 같은 변수들이 정의되어 진다. :

$userfile - 업로드된 파일 내용이 저장되어 있는 서버의 임시 파일명

$userfile_name - 업로드한 시스템에서 사용하는 파일의 원래 이름.

$userfile_size - byte단위의 Upload된 파일의 크기.

$userfile_type - 만약 browser가 업로드된 파일의 mime 형식을 안다면, 그 mime 형식. (Ex. "image/gif").

위 변수의 "$userfile"부분은 upload form에서 TYPE=filed을 가진 INPUT 필드의 이름이 된다. 위의 예제에서 우리는 그 이름은 "userfile"이라고 정했다.

File은 기본적으로 우선 서버의 default temporary directory에 저장된다. 이 디폴트 디렉토리는 PHP가 돌아가는 컴퓨터의 환경변수 "TMPDIR"을 설정하여 변경할 수 있다. 이를 PHP 스크립트 안에서 putenv() 함수를 사용하여 변경하는 것은 동작하지 않는다.

업로드된 파일을 다루는 PHP 스크립트는 해당 파일을 가지고 하는 작업을 설정해 줄 필요가 있다. 예를들어, 여러분은 $file_size변수를 사용하여 너무 작거나 큰 파일을 버릴 수도 있다. 또한 여러분은 $file_type변수를 가지고 특정한 타입에 맞지 않는 파일을 버릴 수 있다. 어떤 로직이던, 여러분은 임시 디렉토리에 있는 파일을 지우거나 나중에 필요할 경우에는 다른 곳에 이동시켜야 한다.

만약 임시 디렉토리에 있는 파일을 해당 request가 끝날 때 까지도 지우거나 이동시키지 않았다면, 이 파일은 해당 request가 종료되는 시점에서 자동으로 지워진다.

일반적인 주의사항 (Common Pitfalls)

MAX_FILE_SIZE 아이템의 값은 PHP3.ini에 설정된 upload_max_filesize의 값이나 Apache .conf에 설정한 php3_upload_max_filesize의 값보다 크게 설정할 수 없다. 기본값은 2메가 바이트이다.

CERN httpd 서버는 client로부터 입력받은 mime header의 앞쪽 여백을 모두 strip off 시켜버리므로, CERN httpd 서버에서는 File Upload 기능이 동작하지 않는다.

여러 파일을 Upload하기 (Uploading multiple files)

한번에 여러개의 파일을 동시에 전송하는 것도 가능하다. 이때 PHP는 이 파일들에 대한 정보를 배열로 전달한다. 따라서 이런 경우에는 여러개를 선택하는 select나 checkbox 때처럼 HTML의 form의 아이템에 동일한 array명을 적어주어야 한다.

Note: 여러 파일 전송 기능은 3.0.10부터 추가된 기능이다. (역자주: php 4.0.0은 버그로 인해 이 기능이 동작하지 않는다)

Example 18-2. Uploading multiple forms 1  2 <form action="file-upload.html" method="post" enctype="multipart/form-data"> 3  Send these files:<br> 4  <input name="userfile[]" type="file"><br> 5  <input name="userfile[]" type="file"><br> 6  <input type="submit" value="Send files"> 7 </form> 8

위의 폼이 전송될 때 $userfile, $userfile_name, $userfile_size의 배열이 전역 변수로 만들어진다. ($HTTP_POST_VARS에도 만들어진다.) 이 배열들은 전송된 파일의 정보를 가지고 있고, 각 배열들은 번호로 인덱스되어 있다.

예를 들어, 위의 예에서 /home/test/review.html 과 /home/test/xwp.out 의 두 개의 파일을 전송했다면 $userfile_name[0]에는 review.html이라는 값이, $userfile_name[1]에는 xwp.out이라는 값이 저장되게 된다. 동시에, $userfile_size[0] 에는 review.html의 파일 크기가 저장되는 식이 된다.

PUT Method Support

PHP는 Netscape Composer나 W3C Amaya같은 클리이언트에 대해 HTTP PUT 방식(method)을 지원한다. PUT 요구(request)는 file upload보다 훨씬 쉽다. 단지 다음과 같이 하면 된다. :

  1 
  2 PUT /path/filename.html HTTP/1.1
  3     

이것은 보통 원격 클라이언트가 보낸 내용을 웹 트리 밑의 /path/filename.html로 저장하라는 의미이다. 그런데 여러분의 웹 트리밑에 있는 파일들을 아무나 덮어 쓸 수 있다는 것은 Apache나 PHP에 있어서 확실히 좋지 않은 생각이다. 따라서 이와 같은 요구를 다루기 전에, 우선 웹 서버에게 이런 요구를 다루는 PHP 스크립트를 미리 지정해 주어야 한다. 아파치에서는 Script 지시자로 그 내용을 지정한다. 이 지시자는 Apache 설정 파일중의 어느 위치에 있어도 괜찮으나, 보통 <Directory> 블록 안이나 <Virtualhost> 블록 안에 위치하는 것이 일반적이다. 보통 다음과 같이 쓰여진다. :

  1 
  2 Script PUT /put.php3
  3     

이것은 이 라인을 위치시킨 블록의 URI에 해당되는 모든 PUT 요구를 put.php3 스크립트에게 전달하라고 Apache에게 알려 준다. 물론 이 경우 .php3 확장자에 대하여 PHP설정이 완료되어 있고, PHP가 작동중이어야 한다.

put.php3 파일내에서는 보통 다음과 같이 사용할 수 있다. :

  1 
  2 <? copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); ?>
  3     

위의 명령은 해당 파일을 원격 클라이언트가 요청한 위치에 복사하는 것이다. 아마 여러분은 복사하기 전에 사용자를 확인하거나 파일을 검사하는 등의 기능을 원할 것이다. 여기서 알 수 있는 것은 PHP가 PUT-method의 요구를 받았을 때 POST-method기능과 마찬가지로 임시 파일에 해당 내용을 저장한다는 것이다. 즉, 요구가 끝나게 되면 임시파일은 지워진다. 따라서 PUT을 다루는 PHP 스크립트는 해당 파일을 어디 다른 곳에 복사해 두어야 한다. 임시파일의 이름은 $PHP_PUT_FILENAME 이라는 변수에 저장되고, $REQUEST_URI 변수에 클라이언트에서 보내온 저장할 파일의 경로와 이름이 저장된다.(Apache가 아닌 웹서버에서는 모양이 조금 달라진다.) 물론 여러분은 이 경로명과 파일명이 아닌 전혀 다른 위치에 다른 파일명을 사용할 수도 있다.

Chapter 19. Using remote files

여러분이 PHP를 설정할 때 "URL fopen wrapper"를 enable로 설정하였다면(이 설정은 --disable-url-fopen-wrapper로 명시하지 않으면 설정된다.), 여러분은 대부분 함수의 파라메타로 있는 파일이름(filename)에 HTTP나 FTP URL을 사용할 수 있다. 심지어 require()나 include() 함수에도 사용이 가능하다.

Note: 단, Windows환경의 include()와 require() 함수에서는 사용할 수 없다.

예를 들어, 여러분은 이 기능을 사용하여 원격 웹 서버가 출력하는 내용을 파일로 열고, 그 출력 내용에서 여러분이 원하는 데이타를 분석하여, 이 원하는 데이타로 데이타베이스 질의에 사용하거나, 여러분의 웹 사이트에 맞는 모양으로 변형 시켜 출력할 수 있다.

Example 19-1. Getting the title of a remote page 1  2 <?php 3  $file = fopen("http://www.php.net/", "r"); 4  if (!$file) { 5  echo "<p>Unable to open remote file.\n"; 6  exit; 7  } 8  while (!feof($file)) { 9  $line = fgets($file, 1024); 10  /* This only works if the title and its tags are on one line. */ 11  if (eregi("<title>(.*)</title>", $line, $out)) { 12  $title = $out[1]; 13  break; 14  } 15  } 16  fclose($file); 17 ?> 18

여러분은 해당 서버에 권한이 있는 사용자로 접속하고, 해당 파일이 존재하지 않는다면, FTP를 이용한 파일로 쓸 수도 있다. 'anonymous'가 아닌 사용자로 접속하려면, URL내에 username을 (필요하다면 password도) 다음과 같이 명시해야 한다 : 'ftp://user:password@ftp.example.com/path/to/file'. (또한 HTTP에서 Basic authentication을 사용한 인증을 요구하는 경우에도 이와 같은 문법을 사용할 수 있다.)

Example 19-2. Storing data on a remote server 1  2 <?php 3  $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); 4  if (!$file) { 5  echo "<p>Unable to open remote file for writing.\n"; 6  exit; 7  } 8  /* Write the data here. */ 9  fputs($file, "$HTTP_USER_AGENT\n"); 10  fclose($file); 11 ?> 12

Note: 여러분은 위의 예제를 보고, 이 테크닉을 사용하여 remote log를 작성할 수 있겠다고 생각할 수도 있다. 그러나 위에 언급한대로 URL fopen() wrapper는 새 파일에만 쓸 수 있다. 여러분이 원하는 대로 분산된 log를 하고 싶다면 syslog()의 내용을 살펴보라.

Chapter 20. Connection handling

Note: 이 기능은 PHP version 3.0.7 이후부터 적용된 것들이다.

내부적으로 PHP는 연결의 상태를 다음 3가지중 하나로 설정한다. :

0 - NORMAL

1 - ABORTED

2 - TIMEOUT

PHP 스크립트가 일반적으로 실행되고 있을 때는 NORMAL 상태가 active된다. 만약 원격 클라이언트가 연결을 끊게되면 ABORTED 상태 flag가 켜지게 된다. 보통 클라이언트가 연결을 끊는 것은 사용자가 STOP 버튼을 눌렀을 때 일어난다. 만약 PHP가 설정한 시간 제한에 (set_time_limit()을 보라) 걸리게 되면 TIMEOUT 상태 flag가 켜지게 된다.

여러분은 클라이언트가 연결을 끊었을 때 스크립트가 수행을 중단할 것인가 아닌가를 결정하여야 한다. 때때로 원격 브라우저가 어떤 결과도 받아들이지 않더라도 스크립트를 끝까지 실행하는 것이 편리할 때가 많다. 기본 동작은 클라이언트가 연결을 끊으면 스크립트도 중단되는 것이다. 이 동작은 ignore_user_abort라는 php3.ini 지시자(directive)나, php3_ignore_user_abort라는 Apache .conf의 지시자로 설정이 가능하고, ignore_user_abort() 함수를 사용하여 설정할 수도 있다. 만약 여러분이 PHP에게 사용자가 내린 중지 명령을 무시하라고 말해주지 않았다면, 사용자의 중지 신호는 여러분의 스크립트를 종료시킨다. 단, register_shutdown_function()을 사용하여 shutdown 함수를 등록해놓은 경우는 예외가 된다. shutdown 함수를 사용하면, 사용자가 STOP버튼을 눌렀을 때, 여러분의 스크립트는 남은 출력을 하려고 하고, PHP는 연결이 중단되었음을 인지하여 shutdown 함수를 호출하게 된다. shutdown 함수는 여러분의 스크립트가 정상적으로 종료되었을 때도 호출 된다. 따라서 클라이언트의 연결 중단 때와 일반적인 종료시에 다른 동작을 원한다면 connection_aborted() 함수를 사용하면 된다. 이 함수는 연결이 중단되었다면 true를 반환한다.

여러분의 스크립트는 내장된 타이머에 의해 종료될 수 있다. 기본 timeout 시간은 30초로 되어 있다. 이것은 max_execution_time이라는 php3.ini 지시자(directive)나 동일한 내용의 php3_max_execution_time이라는 Apache .conf 지시자에 의해 다르게 설정이 가능하고 set_time_limit() 함수를 사용하여 설정할 수도 있다. 시간이 다 되면 스크립트는 중단되고, 이 스크는 위에서 설명한 클라이언트와의 연결이 종료된 것처럼 동작한다. 따라서 shutdown 함수가 등록되어 있다면 이 함수가 실행된다. shutdown 함수내에서 이 함수가 timeout에 의해 호출된 것인가를 판단하려면 connection_timeout() 함수를 사용하면 된다. 이 함수는 timeout에 의해 shutdown 함수가 호출되었다면 true를 반환한다.

한가지 유의할 사항은 ABORTED와 TIMEOUT 상태는 두 개가 동시에 active될 수 있다는 것이다. 이것은 PHP가 사용자 중단을 무시하도록 설정해 놓았을 때 가능하다. 또 다른 경우는 사용자가 연결을 끊지는 않았지만 연결에 어떤 문제가 생겨 연결이 망가진 경우로, 이 때도 스크립트는 계속 실행된다. 이런 경우에 스크립트는 계속실행되고, 시간 제한에 걸려 스크립트의 수행이 중단되고 shutdown 함수가 호출되면, connection_timeout()과 connection_aborted() 함수 모두 true를 반환하게 된다. 여러분은 connection_status() 라는 함수를 사용하여 두가지 상태 모두를 검사할 수 있다. 이 함수는 각 상태에 대한 정보를 bit단위로 가지고 있다. 예를들어 위와같이 ABORT와 TIMEOUT 두 개의 상태가 모두 active되어 있다면 이 함수는 3을 반환한다.

Chapter 21. 영구적인 데이터베이스 접속 (Persistent database connections)

영구적인 접속(Persistent connection)은 여러분의 스크립트가 종료되어도 SQL link를 닫지 않는 접속을 말한다. 영구적인 접속이 요청되면, PHP는 기존의 (이전에 열어 두었던) 동일한(identical) 영구적인 접속이 있는가를 검사한다. 만약 있다면 기존의 것을 사용하고, 없다면 새로운 link를 만든다. '동일한(identical)' 접속이란 같은 호스트에 같은 사용자명(username)과 같은 암호(password)를 사용한 접속을 말한다.

가끔 웹서버의 작동과 작업의 할당에 대해 잘 알고 있지 못한 사람들은 영구적인 접속이 사실은 별 것 아니라고 오해하기도 한다. 특히, 영구적인 접속이 동일한 SQL link에서 'user sessions'를 여는데 별 나을 것도 없다던가, transaction을 효율적으로 처리하는 것도 아니라다던가, 혹은 다른 어떤 작업을 하지 못한다고도 한다. 사실, 이런 말들에 대해 명백히 말하자면, 영구적인 접속은 비영구적인 접속에 비해 어떠한 기능적인 향상도 주지 못한다.

왜?

이것은 웹서버의 동작 방법대로 동작한다. 여러분의 웹서버가 웹 페이지를 만들기위해 PHP를 이용하는데는 3가지 방법이 있다.

첫 번째 방법은 PHP를 CGI "wrapper"이 형태로 사용하는 것이다. 이 방법의 경우, 웹서버에 매 PHP 페이지가 요구될 때 마다, PHP 인터프리터의 실행이 만들어지고 종료된다. 따라서 매 요구가 종료될 때마다 인터프리터의 실행이 종료되므로, 실행 중 만들었던 (SQL link를 포함한) 모든 자원은 실행 종료와 더불어 해제된다. 이 경우 여러분은 영구적입 접속을 사용하여 어떤 이득도 얻을 수 없다. 다르게 말하면 이 경우는 영구적인 접속을 해도 영구적이 아니다.

두 번째 방법은 가장 대중적인 방법인데, PHP를 다중프로세스(multiprocess) 웹서버의 모듈로 사용하는 것이다. (현재는 Apache가 유일하다.) 다중프로세스 서버는 보통 한 개의 부모(parent) 프로세스와, 이와 유기적으로 연결되어 웹 페이지를 실제로 만드는 작업을 하는 여러개의 자식(child) 프로세스들을 가지고 있다. 클라이언트로부터 들어오는 개별 요구는 다른 클라이언트의 료구를 처리하고 있지 않은 남는 자식 프로세스로 넘겨진다. 이것은 동일한 클라이언트가 서버에 두 번째 요구를 보낼 때, 보통 처음과 다른 자식 프로세스에서 처리된다는 것을 의미한다. 이 경우 영구적인 접속을 사용하면 각각의 자식 프로세스들은 처음 요구에서만 SQL 서버에 접속하게 된다. 다른 페이지에서 SQL 서버에의 접속 요구시는 기존에 만들어진 접속을 다시 사용하게 된다.

마지막 방법은 PHP를 멀티쓰레드(multithreaded) 웹서버의 플러그-인의 형태로 작동시키는 것인데, 현재 이방법은 이론적으로만 존재하고, 실제로 만들어 진 것은 없다. ISAPI, WSAPI, NSAPI (Windows에서) 등의 방법을 사용하여 Netscape FastTrack, Microsoft's Internet Information Server (IIS), O'Reilly's WebSite Pro 등의 멀티쓰레드 웹서버에서 PHP를 플러그-인으로 동작시키려는 작업이 현재 진행중이다. 이 경우 기본 동작은 위에서 언급한 다중프로세스 모델과 동일하게 동작한다.

영구적인 접속이 실제로 아무런 기능의 향상도 주지 못한다면, 이것을 사용해 어떤 이점이 있나요?

이것에 대한 간단한 답은 효율성이다. 영구적인 접속은 SQL 서버와의 link를 만드는 것에 따른 overhead가 클 경우에 유용하다. 이  overhead는 많은 요인에 따라 커지기도 하고 작아지기도 한다. 어떤 종류의 데이터베이스인가? 웹서버와 같은 컴퓨터에 데이터베이스 서버가 있는가? SQL 서버가 어떻게 사용되고 있는가? 등에 따라 크게 달라진다. 접속에 따른 overhead가 클 경우에 영구적인 접속은 여러분에게 적지 않은 도움을 줄 것이다. 이것은 자식 process에서 SQL 서버에 접속을 요청할 때 마다 접속을 만드는 대신, 이 프로세스가 종료될 때 까지 살아있는 한 개의 접속 만을 사용한다. 이것은 모든 영구적인 접속을 사용한 프로세스는, 그에 해당하는 한 대의 영구적인 접속을 가지고 있다는 것을 의미한다. 예를 들어 SQL 서버에 대하여 영구적인 접속을 사용하는 스크립트를 실행하였던 20개의 다른 자식 프로세스가 있다면, 아마도 각각의 자식 프로세스에대해 1개씩, 20개의 SQL 접속이 있을 것이다.

중요한 요약 한가지. 영구적인 접속은 일반적인 접속에 1대1로 대응되도록 설계되었다. 이것은 스크립트의 기능은 그대로 두고, 언제라도 비영구적인 연결을 영구적인 연결로 대치할 수 있다는 것을 의미한다. 이것으로 여러분은 아마도 스크립트의 효율을 향상시킬 수 있을 것이다.

IV. Function Reference

(역자주: 이 Reference 부분은 비교적 간단한 내용들이고, 내용의 정확성을 기하기 위해 특별한 경우를 제외하고는 제목 부분만 번역하였다.)

Table of Contents

I. Apache-specific functions

II. Arbitrary precision mathematics functions

III. Array functions

IV. Aspell functions

V. Calendar functions

VI. COM support functions for Windows

VII. Class/Object Functions

VIII. ClibPDF functions

IX. Cybercash payment functions

X. DOM XML functions

XI. Compression functions

XII. Database (dbm-style) abstraction layer functions

XIII. Date and Time functions

XIV. dBase functions

XV. dbm functions

XVI. Directory functions

XVII. Dynamic Loading functions

XVIII. Encryption functions

XIX. filePro functions

XX. Filesystem functions

XXI. Forms Data Format functions

XXII. FTP functions

XXIII. GNU Gettext

XXIV. Hash functions

XXV. HTTP functions

XXVI. Hyperwave functions

XXVII. Image functions

XXVIII. IMAP, POP3, and NNTP functions

XXIX. Informix functions

XXX. InterBase functions

XXXI. LDAP functions

XXXII. Mail functions

XXXIII. Mathematical functions

XXXIV. MCAL functions

XXXV. Microsoft SQL Server functions

XXXVI. Miscellaneous functions

XXXVII. mSQL functions

XXXVIII. MySQL functions

XXXIX. Network functions

XL. NIS functions

XLI. ODBC functions

XLII. Oracle functions

XLIII. Oracle 8 functions

XLIV. PDF functions

XLV. Perl-compatible Regular Expression functions

XLVI. PHP options & information

XLVII. POSIX functions

XLVIII. PostgreSQL functions

XLIX. Program Execution functions

L. GNU Recode functions

LI. Regular expression functions

LII. Semaphore and shared memory functions

LIII. Session handling functions

LIV. SNMP functions

LV. String functions

LVI. Shockwave Flash functions

LVII. Sybase functions

LVIII. URL functions

LIX. Variable functions

LX. Vmailmgr functions

LXI. WDDX functions

LXII. XML parser functions

I. Apache Specific functions

Table of Contents

apache_lookup_uri … Perform a partial request for the specified URI and return all info about it

apache_note … Get and set apache request notes

getallheaders … Fetch all HTTP request headers

virtual … Perform an Apache sub-request

apache_lookup_uri

apache_lookup_uri -- 특정 URI에 대한 부분적인 요청(partial request)을 수행하고 그것에 대한 모든 정보를 돌려준다.

Description

class apache_lookup_uri(string filename);

This performs a partial request for a URI. It goes just far enough to obtain all the important information about the given resource and returns this information in a class. The properties of the returned class are:

status

the_request

status_line

method

content_type

handler

uri

filename

path_info

args

boundary

no_cache

no_local_copy

allowed

send_bodyct

bytes_sent

byterange

clength

unparsed_uri

mtime

request_time

Note: apache_lookup_uri 는 PHP가 모듈로 설치되었을 경우만 동작한다.

apache_note

apache_note -- apache request note를 설정하거나 읽어온다.

Description

string apache_note(string note_name, string [note_value]);

apache_note() is an Apache-specific function which gets and sets values in a request's notes table. If called with one argument, it returns the current value of note note_name. If called with two arguments, it sets the value of note note_name to note_value and returns the previous value of note note_name.

getallheaders

getallheaders -- 모든 HTTP request header를 분석하여 읽어온다.

Description

array getallheaders(void);

This function returns an associative array of all the HTTP headers in the current request.

Note: You can also get at the value of the common CGI variables by reading them from the environment, which works whether or not  you are using PHP as an Apache module. Use phpinfo() to see a list of all of the environment variables defined this way.

  1 
  2 $headers = getallheaders();
  3 while (list($header, $value) = each($headers)) {
  4     echo "$header: $value<br>\n";
  5 }
  6       

This example will display all the request headers for the current request.

Note: GetAllHeaders() 는 PHP가 모듈로 설치되었을 경우만 동작한다.

virtual

virtual -- Apache sub-request를 수행한다.

Description

int virtual(string filename);

II. Arbitrary precision mathematics functions

이 BC 함수들은 PHP가 --enable-bcmath 설정 옵션으로 컴파일 된 경우에만 사용이 가능하다.

Table of Contents

bcadd … Add two arbitrary precision numbers.

bccomp … Compare two arbitrary precision numbers.

bcdiv … Divide two arbitrary precision numbers.

bcmod … Get modulus of an arbitrary precision number.

bcmul … Multiply two arbitrary precision number.

bcpow … Raise an arbitrary precision number to another.

bcscale … Set default scale parameter for all bc math functions.

bcsqrt … Get the square root of an arbitray precision number.

bcsub … Subtract one arbitrary precision number from another.

bcadd

bcadd -- 두 개의 arbitrary precision number를 더한다.

Description

string bcadd(string left operand, string right operand, int [scale]);

Adds the left operand to the right operand and returns the sum in a string. The optional scale parameter is used to set the number of digits after the decimal place in the result.

See also bcsub().

bccomp

bccomp -- 두 arbitrary precision numbers를 비교한다.

Description

int bccomp(string left operand, string right operand, int [scale]);

Compares the left operand to the right operand and returns the result as an integer. The optional scale parameter is used to set the number of digits after the decimal place which will be used in the comparion. The return value is 0 if the two operands are equal. If the left operand is larger than the right operand the return value is +1 and if the left operand is less than the right operand the return value is -1.

bcdiv

bcdiv -- 두 arbitrary precision number를 나눈다.

Description

string bcdiv(string left operand, string right operand, int [scale]);

Divides the left operand by the right operand and returns the result. The optional scale sets the number of digits after the decimal place in the result.

See also bcmul().

bcmod

bcmod -- arbitrary precision number의 나머지를 구한다.

Description

string bcmod(string left operand, string modulus);

Get the modulus of the left operand using modulus.

See also bcdiv().

bcmul

bcmul -- 두 arbitrary precision number를 곱한다.

Description

string bcmul(string left operand, string right operand, int [scale]);

Multiply the left operand by the right operand and returns the result. The optional scale sets the number of digits after the decimal place in the result.

See also bcdiv().

bcpow

bcpow -- arbitrary precision number의 n 제곱한다.

Description

string bcpow(string x, string y, int [scale]);

Raise x to the power y. The scale can be used to set the number of digits after the decimal place in the result.

See also bcsqrt().

bcscale

bcscale -- 모든 bc 수학 함수의 기본 scale parameter를 정한다.

Description

string bcscale(int scale);

This function sets the default scale parameter for all subsequent bc math functions that do not explicitly specify a scale parameter.

bcsqrt

bcsqrt -- arbitray precision number의 제곱근을 구한다.

Description

string bcsqrt(string operand, int scale);

Return the square root of the operand. The optional scale parameter sets the number of digits after the decimal place in the result.

See also bcpow().

bcsub

bcsub -- arbitrary precision number 를 뺀다.

Description

string bcsub(string left operand, string right operand, int [scale]);

Subtracts the right operand from the left operand and returns the result in a string. The optional scale parameter is used to set the number of digits after the decimal place in the result.

See also bcadd().

III. Array functions

Table of Contents

array … Create an array

array_count_values … Counts all the values of an array

array_flip … Flip all the values of an array

array_keys … Return all the keys of an array

array_merge … Merge two or more arrays

array_pad … Pad array to the specified length with a value

array_pop … Pop the element off the end of array

array_push … Push one or more elements onto the end of array

array_reverse … Return an array with elements in reverse order

array_shift … Pop an element of the beginning of array

array_slice … Extract a slice of the array

array_splice … Remove a portion of the array and replace it with something else

array_unshift … Push one or more elements onto the beginning of array

array_values … Return all the values of an array

array_walk … Apply a user function to every member of an array.

arsort … Sort an array in reverse order and maintain index association

asort … Sort an array and maintain index association

compact … Create array containing variables and their values

count … count elements in a variable

current … return the current element in an array

each … return next key/value pair from an array

end … set internal pointer of array to last element

extract … Import variables into the symbol table from an array

in_array … Return true if a value exists in an array

key … fetch a key from an associative array

krsort … Sort an array by key in reverse order

ksort … Sort an array by key.

list … assign variables as if they were an array

next … advance the internal array pointer

pos … return the current element in an array

prev … rewind internal array pointer

range … Create an array containing a range of integers

reset … set internal pointer of array to first element

rsort … Sort an array in reverse order

shuffle … Shuffle an array

sizeof … get size of array

sort … Sort an array

uasort … Sort an array with a user-defined comparison function and maintain index association

uksort … Sort an array by keys using a user-defined comparison function

usort … Sort an array by values using a user-defined comparison function

array

array -- 배열을 만든다.

Description

Returns an array of the parameters. The parameters can be given an index with the => operator.

The following example demonstrates how to create a two-dimensional array, how to specify keys for associative arrays, and how to skip-and-continue numeric indices in normal arrays.

Example 1. array() example 1  2 $fruits = array ( 3  "fruits" => array("a"=>"orange", "b"=>"banana", "c"=>"apple"), 4  "numbers" => array(1, 2, 3, 4, 5, 6), 5  "holes" => array("first", 5 => "second", "third") 6 ); 7

See also: list().

array_count_values

array_flip

array_keys

array_keys -- 배열의 모든 키들을 반환한다,

Description

array_keys() returns the keys, numeric and string, from the input array.

If the optional search_value is specified, then only the keys for that value are returned. Otherwise, all the keys from the input are returned.

Example 1. array_keys() example 1  2 $array = array(0 => 100, "color" => "red"); 3 array_keys ($array); // returns array (0, "color") 4  5 $array = array(1, 100, 2, 100); 6 array_keys ($array, 100); // returns array (0, 2) 7

See also array_values().

Note: This function was added in PHP 4.0.

array_merge

array_merge -- 두 개 이상의 배열을 하나로 합친다.

Description

array_merge() merges the elements of two or more arrays together so that the values of one are appended to the end of the previous one. It returns the resulting array.

If the input arrays had the same string keys, then the later value for that key will overwrite previous one. If, however, the arrays have the same numeric key, this does not happen since the values are appended.

Example 1. array_merge() example 1  2 $array1 = array ("color" => "red", 2, 4); 3 $array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid"); 4 array_merge ($array1, $array2); 5  Resulting array will be array("color" => "green", 2, 4, "a", "b", "shape" => "trapezoid").

array_pad

array_pop

array_pop -- 배열의 맨 뒤에 있는 원소를 꺼내고 그 원소를 삭제한다.

Description

array_pop() pops and returns the last value of the array, shortening the array by one element.

Example 1. array_pop() example 1  2 $stack = array ("orange", "apple", "raspberry"); 3 $fruit = array_pop ($stack); 4  After this, $stack has only 2 elements: "orange" and "apple", and $fruit has "raspberry".

See also array_push(), array_shift(), and array_unshift().

Note: This function was added in PHP 4.0.

array_push

array_push -- 배열의 맨 뒤에 한 개나 그 이상의 원소를 첨가한다.

Description

array_push() treats array as a stack, and pushes the passed variables onto the end of array. The length of array increases by the number of variables pushed. Has the same effect as:

1  2 $array[] = $var; 3

repeated for each var.

Returns the new number of elements in the array.

Example 1. array_push() example 1  2 $stack = array (1, 2); 3 array_push($stack, "+", 3); 4

This example would result in $stack having 4 elements: 1, 2, "+", and 3.

See also array_pop(), array_shift(), and array_unshift().

Note: This function was added in PHP 4.0.

array_reverse

array_shift

array_shift -- 배열의 맨 앞에 있는 원소를 꺼내고 그 원소를 삭제한다.

Description

array_shift() shifts the first value of the array off and returns it, shortening the array by one element and moving everything down.

Example 1. array_shift() example 1  2 $args = array ("-v", "-f"); 3 $opt = array_shift ($args); 4

This would result in $args having one element "-f" left, and $opt being "-v".

See also array_unshift(), array_push(), and array_pop().

Note: This function was added in PHP 4.0.

array_slice

array_slice -- 배열의 일부를 추출한다.

Description

array_slice() returns a sequence of elements from the array specified by the offset and length parameters.

If offset is positive, the sequence will start at that offset in the array. If offset is negative, the sequence will start that far from the end of the array.

If length is given and is positive, then the sequence will have that many elements in it. If length is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from offset up until the end of the array.

Example 1. array_slice() examples 1  2 $input = array ("a", "b", "c", "d", "e"); 3  4 $output = array_slice ($input, 2); // returns "c", "d", and "e" 5 $output = array_slice ($input, 2, -1); // returns "c", "d" 6 $output = array_slice ($input, -2, 1); // returns "d" 7 $output = array_slice ($input, 0, 3); // returns "a", "b", and "c" 8

See also array_splice().

Note: This function was added in PHP 4.0.

array_splice

array_splice -- 배열의 일부를 삭제하고, 그 위치에 다른 내용을 끼워 넣는다.

Description

array_splice() removed the elements designated by offset and length from the input array, and replaces them with the elements of the replacement array, if supplied.

If offset is positive then the start of removed portion is at that offset from the beginning of the input array. If offset is negative then it starts that far from the end of the input array.

If length is omitted, removes everything from offset to the end of the array. If length is specified and is positive, then that many elements will be removed. If length is specified and is negative then the end of the removed portion will be that many elements from the end of the array. Tip: to remove everything from offset to the end of the array when replacement is also specified, use count($input) for length.

If replacement array is specified, then the removed elements are replaced with elements from this array. If offset and length are such that nothing is removed, then the elements from the replacement array are inserted in the place specified by the offset. Tip: if the replacement is just one element it is not necessary to put array() around it, unless the element is an array itself.

The following equivalences hold:

1  2 array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y)) 3 array_pop($input) array_splice($input, -1) 4 array_shift($input) array_splice($input, 0, 1) 5 array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y)) 6 $a[$x] = $y array_splice($input, $x, 1, $y) 7

Returns the array consisting of removed elements.

Example 1. array_splice() examples 1  2 $input = array("red", "green", "blue", "yellow"); 3  4 array_splice($input, 2); // $input is now array("red", "green") 5 array_splice($input, 1, -1); // $input is now array("red", "yellow") 6 array_splice($input, 1, count($input), "orange"); 7  // $input is now array("red", "orange") 8 array_splice($input, -1, 1, array("black", "maroon")); 9  // $input is now array("red", "green", 10  // "blue", "black", "maroon") 11

See also array_slice().

Note: This function was added in PHP 4.0.

array_unshift

array_unshift -- 배열의 맨 앞에 한 개나 그 이상의 원소를 첨가한다.

Description

array_unshift() prepends passed elements to the front of the array. Note that the list of elements is prepended as a whole, so that the prepended elements stay in the same order.

Returns the new number of elements in the array.

Example 1. array_unshift() example 1  2 $queue = array("p1", "p3"); 3 array_unshift($queue, "p4", "p5", "p6"); 4

This would result in $queue having 5 elements: "p4", "p5", "p6", "p1", and "p3".

See also array_shift(), array_push(), and array_pop().

Note: This function was added in PHP 4.0.

array_values

array_values -- 배열의 모든 값들을 반환한다.

Description

array_values() returns all the values from the input array.

Example 1. array_values() example 1  2 $array = array("size" => "XL", "color" => "gold"); 3 array_values($array); // returns array("XL", "gold") 4

array_walk

array_walk -- 배열의 개개의 원소에 특정 함수를 적용하여 수행한다.

Description

Applies the function named by func to each element of arr. func will be passed array value as the first parameter and array key as the second parameter. If userdata is supplied, it will be passed as the third parameter to the user function.

If func requires more than two or three arguments, depending on userdata, a warning will be generated each time array_walk() calls func. These warnings may be suppressed by prepending the '@' sign to the array_walk() call, or by using error_reporting().

Example 1. array_walk() example 1  2 $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); 3  4 function test_alter (&$item1, $key, $prefix) { 5  $item1 = "$prefix: $item1"; 6 } 7  8 function test_print ($item2, $key) { 9  echo "$key. $item2<br>\n"; 10 } 11  12 array_walk ($fruits, 'test_print'); 13 reset ($fruits); 14 array_walk ($fruits, 'test_alter', 'fruit'); 15 reset ($fruits); 16 array_walk ($fruits, 'test_print'); 17

See also each() and list().

arsort

arsort -- 배열을 역순으로 정렬하고 index association을 유지한다.

Description

This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant.

Example 1. arsort() example 1  2 $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); 3 arsort ($fruits); 4 for (reset ($fruits); $key = key ($fruits); next ($fruits)) { 5  echo "fruits[$key] = ".$fruits[$key]."\n"; 6 } 7

This example would display: fruits[a] = orange fruits[d] = lemon fruits[b] = banana fruits[c] = apple The fruits have been sorted in reverse alphabetical order, and the index associated with each element has been maintained.

See also: asort(), rsort(), ksort(), and sort().

asort

asort -- 배열을 정렬하고 index association을 유지한다.

Description

This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant.

Example 1. asort() example 1  2 $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); 3 asort ($fruits); 4 for (reset ($fruits); $key = key ($fruits); next ($fruits)) { 5  echo "fruits[$key] = ".$fruits[$key]."\n"; 6 } 7

This example would display: fruits[c] = apple fruits[b] = banana fruits[d] = lemon fruits[a] = orange The fruits have been sorted in alphabetical order, and the index associated with each element has been maintained.

See also arsort(), rsort(), ksort(), and sort().

compact

compact -- 주어진 여러 변수의 이름과 값을 가지는 배열을 만든다.

Description

compact() takes a variable number of parameters. Each parameter can be either a string containing the name of the variable, or an array of variable names. The array can contain other arrays of variable names inside it; compact() handles it recursively.

For each of these, compact() looks for a variable with that name in the current symbol table and adds it to the output array such that the variable name becomes the key and the contents of the variable become the value for that key. In short, it does the opposite of extract(). It returns the output array with all the variables added to it.

Example 1. compact() example 1  2 $city = "San Francisco"; 3 $state = "CA"; 4 $event = "SIGGRAPH"; 5  6 $location_vars = array ("city", "state"); 7  8 $result = compact ("event", $location_vars); 9  After this, $result will be array ("event" => "SIGGRAPH", "city" => "San Francisco", "state" => "CA").

See also extract().

Note: This function was added in PHP 4.0.

count

count -- 배열 변수의 원소 개수를 구한다.

Description

Returns the number of elements in var, which is typically an array (since anything else will have one element).

Returns 1 if the variable is not an array.

Returns 0 if the variable is not set.

See also: sizeof(), isset(), and is_array().

current

current -- 배열의 현재 원소를 돌려준다.

Description

mixed current(array array);

각각의 배열 변수는 그것의 원소를 가르키는 내부적인 pointer를 가지고 있다. 게다가, 배열의 모든 원소들은 검색이 용이하도록 양방향 linked list로 연결되어 있다. 이 내부적인 pointer는 다른 어떤 조작을 하기 전에는 항상 첫 번째 요소를 가르키고 있다.

current() 함수는 단순히 내부적인 Pointer가 가르키고 있는 원소를 반환할 뿐이다. 만약 이 pointer가 원소 list의 범위를 넘어서 지시하고 있다면 current()는 false를 반환한다.

See also: end(), next(), prev() and reset().

each

each -- 배열에서 다음 key/value 쌍을 돌려준다.

Description

array each(array array);

array 배열에서 다음 key/value 쌍을 반환한다. 이 쌍은 네 개의 원소를 가진 배열로 반환되는데 이 네 개의 원소의 key는 0, 1, key, value이다. 0과 key 원소는 각각 변수의 key 이름을 가지고, 1과 value는 그 값을 가지고 있다.

Example 1. each() examples 1  2 $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); 3 $bar = each ($foo); 4  $bar now contains the following key/value pairs: 0 => 0 1 => 'bob' key => 0 value => 'bob' 1  2 $foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); 3 $bar = each ($foo); 4  $bar now contains the following key/value pairs: 0 => 'Robert' 1 => 'Bob' key => 'Robert' value => 'Bob'

보통 each()는 list() 함수와 함께 배열을 탐색하는데 사용된다. 예를 들어 다음과 같이 $HTTP_POST_VARS와 같은 배열을 탐색하는데 많이 사용된다

Example 2. Traversing $HTTP_POST_VARS with each() 1  2 echo "Values submitted via POST method:<br>"; 3 reset ($HTTP_POST_VARS); 4 while (list ($key, $val) = each ($HTTP_POST_VARS)) { 5  echo "$key => $val<br>"; 6 } 7

After each() has executed, the array cursor will be left on the next element of the array, or on the last element if it hits the end of the array.

See also key(), current(), reset(), next(), and prev().

end

end -- 배열의 내부적인(internal) pointer를 맨 마지막 원소로 옮긴다.

Description

end(array array);

end() advances array's internal pointer to the last element.

See also: current(), end() next() and reset()

extract

extract -- 배열의 내용을 심볼 테이블로 읽어들여 일반적인 변수로 만든다.

Description

This function is used to import variables from an array into the current symbol table. It takes associative array var_array and treats keys as variable names and values as variable values. For each key/value pair it will create a variable in the current symbol table, subject to extract_type and prefix parameters.

extract() checks for colissions with existing variables. The way collisions are treated is determined by extract_type. It can be one of the following values:

EXTR_OVERWRITE

If there is a collision, overwrite the existing variable.

EXTR_SKIP

If there is a collision, don't overwrite the existing variable.

EXTR_PREFIX_SAME

If there is a collision, prefix the new variable with prefix.

EXTR_PREFIX_ALL

Prefix all variables with prefix.

If extract_type is not specified, it is assumed to be EXTR_OVERWRITE.

Note that prefix is only required if extract_type is EXTR_PREFIX_SAME or EXTR_PREFIX_ALL.

extract() checks each key to see if it constitues a valid variable name, and if it does only then does it proceed to import it.

A possible use for extract is to import into symbol table variables contained in an associative array returned by wddx_deserialize().

Example 1. Extract() example 1  2 <php? 3  4 /* Suppose that $var_array is an array returned from 5  wddx_deserialize */ 6  7 $size = "large"; 8 $var_array = array ("color" => "blue", 9  "size" => "medium", 10  "shape" => "sphere"); 11 extract ($var_array, EXTR_PREFIX_SAME, "wddx"); 12  13 print "$color, $size, $shape, $wddx_size\n"; 14  15 ?> 16

The above example will produce:

1  2 blue, large, sphere, medium 3

The $size wasn't overwritten, becaus we specified EXTR_PREFIX_SAME, which resulted in $wddx_size being created. If EXTR_SKIP was specified, then $wddx_size wouldn't even have been created. EXTR_OVERWRITE would have cause $size to have value "medium", and EXTR_PREFIX_ALL would result in new variables being named $wddx_color, $wddx_size, and $wddx_shape.

in_array

in_array -- 배열에 찾는 값이 있으면 true를 반환한다.

Description

Searches haystack for needle and returns true if it is found in the array, false otherwise.

Example 1. in_array() example 1  2 $os = array ("Mac", "NT", "Irix", "Linux"); 3 if (in_array ("Irix", $os)) 4  print "Got Irix"; 5

key

key --배열(associative array)에서 내부적인(internal) pointer가 가리키고 있는 원소의 key 값을 가져온다.

Description

mixed prev(array array);

key() returns the index element of the current array position.

See also: current() next()

krsort

See also asort(), arsort(), ksort(), sort(), and rsort().

ksort

ksort -- key 순으로 배열을 정렬한다.

Description

Sorts an array by key, maintaining key to data correlations. This is useful mainly for associative arrays.

Example 1. ksort() example 1  2 $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); 3 ksort ($fruits); 4 for (reset ($fruits); $key = key ($fruits); next ($fruits)) { 5  echo "fruits[$key] = ".$fruits[$key]."\n"; 6 } 7

This example would display: fruits[a] = orange fruits[b] = banana fruits[c] = apple fruits[d] = lemon

See also asort(), arsort(), sort(), and rsort().

list

list -- 변수를 배열인 것처럼 만든다.

Description

void list(...);

Like array(), this is not really a function, but a language construct. list() is used to assign a list of variables in one operation.

Example 1. list() example 1  2 <table> 3  <tr> 4  <th>Employee name</th> 5  <th>Salary</th> 6  </tr> 7  8 <?php 9  10 $result = mysql($conn, "SELECT id, name, salary FROM employees"); 11 while (list($id, $name, $salary) = mysql_fetch_row($result)) { 12  print(" <tr>\n". 13  " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". 14  " <td>$salary</td>\n". 15  " </tr>\n"); 16 } 17  18 ?> 19  20 </table> 21

See also: array().

next

next -- 배열의 internal pointer를 하나 전진시킨다.

Description

Returns the array element in the next place that's pointed by the internal array pointer, or false if there are no more elements.

next() behaves like current(), with one difference. It advances the internal array pointer one place forward before returning the element. That means it returns the next array element and advances the internal array pointer by one. If advancing the internal array pointer results in going beyond the end of the element list, next() returns false.

See also: current(), end() prev() and reset()

pos

pos -- 배열의 현재 원소를 return한다.

Description

mixed pos(array array);

This is an alias for current().

See also: end(), next(), prev() and reset().

prev

prev -- 배열의 internal pointer를 하나 뒤로 후진시킨다.

Description

mixed prev(array array);

Returns the array element in the previous place that's pointed by the internal array pointer, or false if there are no more elements.

prev() behaves just like next(), except it rewinds the internal array pointer one place instead of advancing it.

See also: current(), end() next() and reset()

range

range -- 일정 범위에 있는 정수값을 일렬로 가진 배열을 만든다.

Description

array range(int low, int high);

range() returns an array of integers from low to high, inclusive.

이 함수의 사용 예는 shuffle()에 나와있다.

reset

reset -- 배열의 internal pointer를 맨 처음 원소로 설정한다.

Description

reset() rewinds array's internal pointer to the first element.

reset() returns the value of the first array element.

See also: current(), next() prev() and reset()

rsort

rsort -- 배열을 역순으로 정렬한다.

Description

This function sorts an array in reverse order (highest to lowest).

Example 1. rsort() example 1  2 $fruits = array ("lemon", "orange", "banana", "apple"); 3 rsort ($fruits); 4 for (reset ($fruits); list ($key, $value) = each ($fruits); ) { 5  echo "fruits[$key] = ", $value, "\n"; 6 } 7

This example would display: fruits[0] = orange fruits[1] = lemon fruits[2] = banana fruits[3] = apple The fruits have been sorted in reverse alphabetical order.

See also arsort(), asort(), ksort(), and sort().

shuffle

shuffle -- 배열의 내용을 뒤섞는다.

Description

This function shuffles (randomizes the order of the elements in) an array.

Example 1. shuffle() example 1  2 $numbers = range (1,20); 3 srand (time()); 4 shuffle ($numbers); 5 while (list(, $number) = each ($numbers)) { 6  echo "$number "; 7 } 8

See also arsort(), asort(), ksort(), rsort(), sort() and usort().

sizeof

sizeof -- 배열의 크기를 구한다. 원소의 개수가 구해진다.

Description

int sizeof(array array);

Returns the number of elements in the array.

See also: count()

sort

sort -- 배열을 정렬한다.

Description

This function sorts an array. Elements will be arranged from lowest to highest when this function has completed.

Example 1. sort() example 1  2 $fruits = array ("lemon", "orange", "banana", "apple"); 3 sort ($fruits); 4 for (reset ($fruits); $key = key ($fruits); next ($fruits)) { 5  echo "fruits[$key] = ".$fruits[$key]."\n"; 6 } 7

This example would display: fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange The fruits have been sorted in alphabetical order.

 See also arsort(), asort(), ksort(), rsort(), and usort().

uasort

uasort -- 사용자가 지정한 비교 함수를 사용하여 정렬하고 index association을 유지한다.

Description

void uasort(array array, function cmp_function);

This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant. The comparison function is user-defined.

uksort

uksort -- 사용자가 지정한 비교 함수를 사용하여 key 순으로 정렬한다.

Sort an array by keys using a user-defined comparison function

Description

This function will sort the keys of an array using a user-supplied comparison function. If the array you wish to sort needs to be sorted by some non-trivial criteria, you should use this function.

Example 1. uksort() example 1  2 function mycompare ($a, $b) { 3  if ($a == $b) return 0; 4  return ($a > $b) ? -1 : 1; 5 } 6 $a = array (4 => "four", 3 => "three", 20 => "twenty", 10 => "ten"); 7 uksort ($a, mycompare); 8 while (list ($key, $value) = each ($a)) { 9  echo "$key: $value\n"; 10 } 11

This example would display: 20: twenty 10: ten 4: four 3: three

See also arsort(), asort(), uasort(), ksort(), rsort() and sort().

usort

usort -- 사용자가 지정한 비교 함수를 사용하여 value 순으로 정렬한다.

Description

This function will sort an array by its values using a user-supplied comparison function. If the array you wish to sort needs to be sorted by some non-trivial criteria, you should use this function.

The comparison function must return an integer less than, equal to, or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second. If two members compare as equal, their order in the sorted array is undefined.

Example 1. usort() example 1  2 function cmp ($a, $b) { 3  if ($a == $b) return 0; 4  return ($a > $b) ? -1 : 1; 5 } 6 $a = array (3, 2, 5, 6, 1); 7 usort ($a, cmp); 8 while (list ($key, $value) = each ($a)) { 9  echo "$key: $value\n"; 10 } 11

This example would display: 0: 6 1: 5 2: 3 3: 2 4: 1

See also arsort(), asort(), ksort(), rsort() and sort().

IV. Aspell functions

aspell() 함수들은 여러분에게 단어의 철자를 검사하고 수정사항을 조언해 준다.

이 함수들을 사용하려면 aspell 라이브러리가 필요하다. 다음 사이트에서 찾을 수 있을 것이다. : http://metalab.unc.edu/kevina/aspell/

Table of Contents

aspell_new … load a new dictionary

aspell_check … check a word

aspell_check-raw … check a word without changing its case or trying to trim it

aspell_suggest … suggest spellings of a word

aspell_new

aspell_new -- 새 사전을 읽어 온다.

Description

aspell_new() opens up a new dictionary and returns the dictionary link identifier for use in other aspell functions.

Example 1. aspell_new 1  2 $aspell_link=aspell_new("english"); 3

aspell_check

aspell_check -- 단어를 검사한다.

Description

aspell_check() checks the spelling of a word and returns true if the spelling is correct, false if not.

Example 1. aspell_check 1  2 $aspell_link=aspell_new("english"); 3 if (aspell_check($aspell_link,"testt")) { 4  echo "This is a valid spelling"; 5 } else { 6  echo "Sorry, wrong spelling"; 7 } 8

aspell_check-raw

aspell_check-raw -- 단어의 대/소문자를 변환하지 않고, 앞뒤의 공백도 제거하지 않은 채로 검사한다.

Description

aspell_check_raw() checks the spelling of a word, without changing its case or trying to trim it in any way and returns true if the spelling is correct, false if not.

Example 1. aspell_check_raw 1  2 $aspell_link=aspell_new("english"); 3 if (aspell_check_raw($aspell_link,"testt")) { 4  echo "This is a valid spelling"; 5 } else { 6  echo "Sorry, wrong spelling"; 7 } 8

aspell_suggest

aspell_suggest -- 단어의 철자를 조언해 준다.

Description

aspell_suggest() returns an array of possible spellings for the given word.

Example 1. aspell_suggest 1  2 $aspell_link=aspell_new("english"); 3  4 if (!aspell_check($aspell_link,"testt")) { 5  $suggestions=aspell_suggest($aspell_link,"testt"); 6  7  for($i=0; $i < count($suggestions); $i++) { 8  echo "Possible spelling: " . $suggestions[$i] . "<br>"; 9  } 10 } 11

V. Calendar functions

PHP에는 서로 다른 날짜(달력) 형태를 변환시켜 주는 함수들을 제공한다. Julian Day Count가 기본이 된다. 이것은 BC4000년의 어느 시점을 기준으로 잡아 그곳에서부터 얼마의 날짜가 지났는지를 기준으로 삼는 것이다. 이 Julian Day Count는 일반적으로 사용하는 Julian 달력과는 다르다는 것을 알아두자. Calendar 시스템에 대해 자세히 알고 싶다면 http://genealogy.org/~scottlee/cal-overview.html를 방문하여 보라. 이 설명서중에서는 위의 페이지에서 발췌된 내용을 ""로 둘러 싸고 있다.

( 역자주 : 이 함수들은 dl/calender extension을 Load한 후에 사용가능하다. dl/README 파일을 읽어보라. )

Table of Contents

JDToGregorian … Converts Julian Day Count to Gregorian date

GregorianToJD … Converts a Gregorian date to Julian Day Count

JDToJulian … Converts a Julian Calendar date to Julian Day Count

JulianToJD … Converts a Julian Calendar date to Julian Day Count

JDToJewish … Converts a Julian Day Count to the Jewish Calendar

JewishToJD … Converts a date in the Jewish Calendar to Julian Day Count

JDToFrench … Converts a Julian Day Count to the French Republican Calendar

FrenchToJD … Converts a date from the French Republican Calendar to a Julian Day Count

JDMonthName … Returns a month name

JDDayOfWeek … Returns the day of the week

easter_date … get UNIX timestamp for midnight on Easter of a given year

easter_days … get number of days after March 21 on which Easter falls for a given year

JDToGregorian

JDToGregorian -- Julian Day Count를 Gregorian date로 변환

Description

string jdtogregorian(int julianday);

Converts Julian Day Count to a string containing the Gregorian date in the format of "month/day/year"

GregorianToJD

GregorianToJD -- Gregorian date를 Julian Day Count로 변환

Description

int gregoriantojd(int month, int day, int year);

Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.

Although this software can handle dates all the way back to 4714 B.C., such use may not be meaningful. The Gregorian calendar was not instituted until October 15, 1582 (or October 5, 1582 in the Julian calendar). Some countries did not accept it until much later. For example, Britain converted in 1752, The USSR in 1918 and Greece in 1923. Most European countries used the Julian calendar prior to the Gregorian.

Example 1. Calendar functions 1  2 <?php 3 $jd = GregorianToJD(10,11,1970); 4 echo("$jd\n"); 5 $gregorian = JDToGregorian($jd); 6 echo("$gregorian\n"); 7 ?> 8

JDToJulian

JDToJulian -- Julian Day Count를 Julian Calendar date로 변환

Description

string jdtojulian(int julianday);

Converts Julian Day Count to a string containing the Julian Calendar Date in the format of "month/day/year".

JulianToJD

JulianToJD -- Julian Calendar date를 Julian Day Count로 변환

Description

int juliantojd(int month, int day, int year);

Valid Range for Julian Calendar 4713 B.C. to 9999 A.D.

Although this software can handle dates all the way back to 4713 B.C., such use may not be meaningful. The calendar was created in 46 B.C., but the details did not stabilize until at least 8 A.D., and perhaps as late at the 4th century. Also, the beginning of a year varied from one culture to another - not all accepted January as the first month.

JDToJewish

JDToJewish -- Julian Day Count를 the 유대 Calendar로 변환.

Description

string jdtojewish(int julianday);

Converts a Julian Day Count the the Jewish Calendar.

JewishToJD

JewishToJD -- 유대 Calendar를 Julian Day Count로 변환.

Description

int jewishtojd(int month, int day, int year);

Valid Range Although this software can handle dates all the way back to the year 1 (3761 B.C.), such use may not be meaningful.

The Jewish calendar has been in use for several thousand years, but in the early days there was no formula to determine the start of a month. A new month was started when the new moon was first observed.

JDToFrench

JDToFrench -- Julian Day Count를 French Republican Calendar로 변환.

Description

string jdtofrench(int month, int day, int year);

Converts a Julian Day Count to the French Republican Calendar.

FrenchToJD

FrenchToJD -- French Republican Calendar를 Julian Day Count로 변환.

Description

int frenchtojd(int month, int day, int year);

Converts a date from the French Republican Calendar to a Julian Day Count

These routines only convert dates in years 1 through 14 (Gregorian dates 22 September 1792 through 22 September 1806). This more than covers the period when the calendar was in use.

JDMonthName

JDMonthName -- 월의 이름을 반환

Description

string jdmonthname(int julianday, int mode);

Returns a string containing a month name. mode tells this function which calendar to convert the Julian Day Count to, and what type of month names are to be returned.

Table 1. Calendar modes

Mode	Meaning
0	Gregorian - apreviated
1	Gregorian
2	Julian - apreviated
3	Julian
4	Jewish
5	French Republican

JDDayOfWeek

JDDayOfWeek -- 해당 날짜의 요일을 반환한다.

Description

mixed jddayofweek(int julianday, int mode);

Returns the day of the week. Can return a string or an int depending on the mode.

Table 1. Calendar week modes

Mode	Meaning
0	returns the day number as an int (0=sunday, 1=monday, etc)
1	returns string containing the day of week (english-gregorian)
2	returns a string containing the abreviated day of week (english-gregorian)

easter_date

easter_date -- 주어진 연도의 부활절의 자정에 대한 UNIX timestamp를 얻는다.

Description

Returns the UNIX timestamp corresponding to midnight on Easter of the given year. If no year is specified, the current year is assumed.

Warning: This function will generate a warning if the year is outside of the range for UNIX timestamps (i.e. before 1970 or after 2037).

Example 1. easter_date() example 1  2 echo date( "M-d-Y", easter_date(1999) ); /* "Apr-04-1999" */ 3 echo date( "M-d-Y", easter_date(2000) ); /* "Apr-23-2000" */ 4 echo date( "M-d-Y", easter_date(2001) ); /* "Apr-15-2001" */ 5

The date of Easter Day was defined by the Council of Nicaea in AD325 as the Sunday after the first full moon which falls on or after the Spring Equinox. The Equinox is assumed to always fall on 21st March, so the calculation reduces to determining the date of the full moon and the date of the following Sunday. The algorithm used here was introduced around the year 532 by Dionysius Exiguus. Under the Julian Calendar (for years before 1753) a simple 19-year cycle is used to track the phases of the Moon. Under the Gregorian Calendar (for years after 1753 - devised by Clavius and Lilius, and introduced by Pope Gregory XIII in October 1582, and into Britain and its then colonies in September 1752) two correction factors are added to make the cycle more accurate.

(The code is based on a C program by Simon Kershaw, <webmaster@ely.anglican.org>)

See easter_days() for calculating Easter before 1970 or after 2037.

easter_days

easter_days -- 주어진 연도의 부활절이 3월 21일로부터 며칠이 지난 것인지를 얻는다.

Description

Returns the number of days after March 21 on which Easter falls for a given year. If no year is specified, the current year is assumed.

This function can be used instead of easter_date() to calculate Easter for years which fall outside the range of UNIX timestamps (i.e. before 1970 or after 2037).

Example 1. easter_date() example 1  2 echo easter_days(1999); /* 14, i.e. April 4 */ 3 echo easter_days(1492); /* 32, i.e. April 22 */ 4 echo easter_days(1913); /* 2, i.e. March 23 */ 5

The date of Easter Day was defined by the Council of Nicaea in AD325 as the Sunday after the first full moon which falls on or after the Spring Equinox. The Equinox is assumed to always fall on 21st March, so the calculation reduces to determining the date of the full moon and the date of the following Sunday. The algorithm used here was introduced around the year 532 by Dionysius Exiguus. Under the Julian Calendar (for years before 1753) a simple 19-year cycle is used to track the phases of the Moon. Under the Gregorian Calendar (for years after 1753 - devised by Clavius and Lilius, and introduced by Pope Gregory XIII in October 1582, and into Britain and its then colonies in September 1752) two correction factors are added to make the cycle more accurate.

(The code is based on a C program by Simon Kershaw, <webmaster@ely.anglican.org>)

See also easter_date().

VI. COM support functions for Windows

Table of Contents

com_load … ???

com_invoke … ???

com_propget … ???

com_get … ???

com_propput … ???

com_propset … ???

com_set … ???

com_load

com_invoke

com_propget

com_get

com_propput

com_propset

com_set

get_class_methods

get_class_vars

Returns an array of default properties of the class

get_object_vars

method_exists

Checks if the class method exists

VIII. ClibPDF functions

ClibPDF는 PHP에서 pdf 문서를 만들 수 있게 해 준다. 이것은 FastIO에서 구할 수 있으나 무료(free software)는 아니다. 여러분은 ClibPDF를 사용하기 전에 라이센스를 자세히 읽어봐야 할 것이다. 만약 여러분이 이 라이센스에 동의하기를 원하지 않으면 Thomas Merz의 pdflib의 사용을 고려 할 수도 있다. pdflib도 역시 강력한 기능을 가지고 있다. ClibPDF는 Thomas Merz의 pdflib와 기능이나 API가 매우 유사하지만, FastIO에 따르면 ClibPDF는 문서를 더 작은 크기로 더 빠르게 만들 수 있다고 한다. ClibPDF는 pdflib 새로운 2.0 버전에서 변화된 것 같다. 간단한 예제(pdflib 2.0의 pdfclock.c를 php 스크립트로 고친 것)에서는 실질적인 속도의 차이는 없었다. 또한 압축기능을 꺼 놓으면 두 개의 파일 크기도 비슷하다.

여기의 설면은 ClibPDF의 매뉴얼과 같이 읽는 것이 좋을 것이다. 이 매뉴얼은 라이브러리에 대한 더 자세한 설명을 하고 있다. ClibPDF의 매뉴얼의 내용을 이해여야 여러분은 PHP에서 이 라이브러리를 사용할 수 있을 것이다.

대부분의 PHP 모듈의 함수이름은 ClibPDF 고유의 함수(pdflib도 마찬가지고) 이름과 동일하다. cpdf_open() 을 제외한 모든 함수들은 첫 번째 인수로 작업할 문서의 핸들을 가지게 된다. 현재 ClibPDF가 동시에 여러개의 PDF 문서를 만들지 못하기 때문에 이 핸들은 내부적으로 아무 의미가 없다. 그러나 이를 시험하지는 말라. 어떤 결과가 나올지 알 수 없다. 더구나 멀티 쓰레드 환경에서는 중대한 오류가 생길 수도 있다. ClibPDF의 제작자에 따르면 이 내용은 다음 버전에서 수정될 것이라고 한다.(현재 버전은 1.10이다.) 여러문서를 동시에 만드는 기능이 필요하다면 pdflib module을 사용하도록 하라.

Note: PHP3 이후로 cpdf_set_font()  함수는 2byte의 아시안 폰트를 지원하도록 바뀌었다. 그리고, 이 함수의 엔코딩 파라메터는 이제 정수값이 아니고 문자열이다.

pdflib에 비해서 ClibPDF의 가장 큰 장점은 pdf 문서를 임시 파일을 사용하지 않고 메모리 상에서 만들 수 있다는 점이다. 또한 ClibPDF는 미리 정의된 유닛 길이의 좌표를 넘겨줄 수 있다. 이것은 매유 편리한 기능이지만 pdflib에서도 pdf_translate()를 사용하면 비슷한 기능을 할 수 있다.

대부분의 함수들은 사용하기 쉽다. 간단한 pdf 문서를 하나 만들어보면 별로 어렵지 않다는 것을 알 수 있을 것이다. 다음 예를 보면 쉽게 시작할 수 있다. 이것은 한 장짜리 test.pdf라는 파일을 만드는 것이다. 이 페이지에는 외곽선 30pt의 "Times-Roman" 폰트의 text가 쓰여진다. 이 text는 밑줄이 그어진다.

Example 1. Simple ClibPDF Example 1  2 <?php 3 $cpdf = cpdf_open(0); 4 cpdf_page_init($cpdf, 1, 0, 595, 842); 5 cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1"); 6 cpdf_set_font($cpdf, "Times-Roman", 30, "WinAnsiEncoding"); 7 cpdf_set_text_rendering($cpdf, 1); 8 cpdf_text($cpdf, "Times Roman outlined", 50, 750); 9 cpdf_moveto($cpdf, 50, 740); 10 cpdf_lineto($cpdf, 330, 740); 11 cpdf_stroke($cpdf); 12 cpdf_finalize($cpdf); 13 Header("Content-type: application/pdf"); 14 cpdf_output_buffer($cpdf); 15 cpdf_close($cpdf); 16 ?> 17

pdflib 배포본에 보면 아나로그 시계가 포함된 여러 페이지의 문서를 만드는 조금은 복잡한 예제가 있다. 여기 그 예제를 ClibPDF 확장을 사용한 PHP로 변환한 예가 있다.

Example 2. pdfclock example from pdflib 2.0 distribution 1  2 <?php 3 $radius = 200; 4 $margin = 20; 5 $pagecount = 40; 6  7 $pdf = cpdf_open(0); 8 cpdf_set_creator($pdf, "pdf_clock.php3"); 9 cpdf_set_title($pdf, "Analog Clock"); 10  11 while($pagecount-- > 0) { 12  cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1.0); 13  14  cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0); /* wipe */ 15  16  cpdf_translate($pdf, $radius + $margin, $radius + $margin); 17  cpdf_save($pdf); 18  cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); 19  20  /* minute strokes */ 21  cpdf_setlinewidth($pdf, 2.0); 22  for ($alpha = 0; $alpha < 360; $alpha += 6) 23  { 24  cpdf_rotate($pdf, 6.0); 25  cpdf_moveto($pdf, $radius, 0.0); 26  cpdf_lineto($pdf, $radius-$margin/3, 0.0); 27  cpdf_stroke($pdf); 28  } 29  30  cpdf_restore($pdf); 31  cpdf_save($pdf); 32  33  /* 5 minute strokes */ 34  cpdf_setlinewidth($pdf, 3.0); 35  for ($alpha = 0; $alpha < 360; $alpha += 30) 36  { 37  cpdf_rotate($pdf, 30.0); 38  cpdf_moveto($pdf, $radius, 0.0); 39  cpdf_lineto($pdf, $radius-$margin, 0.0); 40  cpdf_stroke($pdf); 41  } 42  43  $ltime = getdate(); 44  45  /* draw hour hand */ 46  cpdf_save($pdf); 47  cpdf_rotate($pdf, -(($ltime['minutes']/60.0) + $ltime['hours'] - 3.0) * 30.0); 48  cpdf_moveto($pdf, -$radius/10, -$radius/20); 49  cpdf_lineto($pdf, $radius/2, 0.0); 50  cpdf_lineto($pdf, -$radius/10, $radius/20); 51  cpdf_closepath($pdf); 52  cpdf_fill($pdf); 53  cpdf_restore($pdf); 54  55  /* draw minute hand */ 56  cpdf_save($pdf); 57  cpdf_rotate($pdf, -(($ltime['seconds']/60.0) + $ltime['minutes'] - 15.0) * 6.0); 58  cpdf_moveto($pdf, -$radius/10, -$radius/20); 59  cpdf_lineto($pdf, $radius * 0.8, 0.0); 60  cpdf_lineto($pdf, -$radius/10, $radius/20); 61  cpdf_closepath($pdf); 62  cpdf_fill($pdf); 63  cpdf_restore($pdf); 64  65  /* draw second hand */ 66  cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); 67  cpdf_setlinewidth($pdf, 2); 68  cpdf_save($pdf); 69  cpdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); 70  cpdf_moveto($pdf, -$radius/5, 0.0); 71  cpdf_lineto($pdf, $radius, 0.0); 72  cpdf_stroke($pdf); 73  cpdf_restore($pdf); 74  75  /* draw little circle at center */ 76  cpdf_circle($pdf, 0, 0, $radius/30); 77  cpdf_fill($pdf); 78  79  cpdf_restore($pdf); 80  81  cpdf_finalize_page($pdf, $pagecount+1); 82 } 83  84 cpdf_finalize($pdf); 85 Header("Content-type: application/pdf"); 86 cpdf_output_buffer($pdf); 87 cpdf_close($pdf); 88 ?> 89

Table of Contents

cpdf_global_set_document_limits … Sets document limits for any pdf document

cpdf_set_creator … Sets the creator field in the pdf document

cpdf_set_title … Sets the title field of the pdf document

cpdf_set_subject … Sets the subject field of the pdf document

cpdf_set_keywords … Sets the keywords field of the pdf document

cpdf_open … Opens a new pdf document

cpdf_close … Closes the pdf document

cpdf_page_init … Starts new page

cpdf_finalize_page … Ends page

cpdf_finalize … Ends document

cpdf_output_buffer … Outputs the pdf document in memory buffer

cpdf_save_to_file … Writes the pdf document into a file

cpdf_set_current_page … Sets current page

cpdf_begin_text … Starts text section

cpdf_end_text … ends text section

cpdf_show … Output text at current position

cpdf_show_xy … Output text at position

cpdf_text … Output text with parameters

cpdf_set_font … Select the current font face and size

cpdf_set_leading … Sets distance between text lines

cpdf_set_text_rendering … Determines how text is rendered

cpdf_set_horiz_scaling … Sets horizontal scaling of text

cpdf_set_text_rise … Sets the text rise

cpdf_set_text_matrix … Sets the text matrix

cpdf_set_text_pos … Sets text position

cpdf_set_char_spacing … Sets character spacing

cpdf_set_word_spacing … Sets spacing between words

cpdf_continue_text … Output text in next line

cpdf_stringwidth … Returns width of text in current font

cpdf_save … Saves current enviroment

cpdf_restore … Restores formerly saved enviroment

cpdf_translate … Sets origin of coordinate system

cpdf_scale … Sets scaling

cpdf_rotate … Sets rotation

cpdf_setflat … Sets flatness

cpdf_setlinejoin … Sets linejoin parameter

cpdf_setlinecap … Sets linecap aparameter

cpdf_setmiterlimit … Sets miter limit

cpdf_setlinewidth … Sets line width

cpdf_setdash … Sets dash pattern

cpdf_moveto … Sets current point

cpdf_rmoveto … Sets current point

cpdf_curveto … Draws a curve

cpdf_lineto … Draws a line

cpdf_rlineto … Draws a line

cpdf_circle … Draw a circle

cpdf_arc … Draws an arc

cpdf_rect … Draw a rectangle

cpdf_closepath … Close path

cpdf_stroke … Draw line along path

cpdf_closepath_stroke … Close path and draw line along path

cpdf_fill … Fill current path

cpdf_fill_stroke … Fill and stroke current path

cpdf_closepath_fill_stroke … Close, fill and stroke current path

cpdf_clip … Clips to current path

cpdf_setgray_fill … Sets filling color to gray value

cpdf_setgray_stroke … Sets drawing color to gray value

cpdf_setgray … Sets drawing and filling color to gray value

cpdf_setrgbcolor_fill … Sets filling color to rgb color value

cpdf_setrgbcolor_stroke … Sets drawing color to rgb color value

cpdf_setrgbcolor … Sets drawing and filling color to rgb color value

cpdf_add_outline … Adds bookmark for current page

cpdf_set_page_animation … Sets duration between pages

cpdf_import_jpeg … Opens a JPEG image

cpdf_place_inline_image … Places an image on the page

cpdf_add_annotation … Adds annotation

cpdf_global_set_document_limits

cpdf_set_creator

cpdf_set_creator -- pdf 문서에서 creator 필드를 설정한다.

Description

void cpdf_set_creator(string creator);

The cpdf_set_creator() function sets the creator of a pdf document.

See also cpdf_set_subject(), cpdf_set_title(), cpdf_set_keywords().

cpdf_set_title

cpdf_set_title -- pdf 문서에서 title 필드를 설정한다.

Description

void cpdf_set_title(string title);

The cpdf_set_title() function sets the title of a pdf document.

See also cpdf_set_subject(), cpdf_set_creator(), cpdf_set_keywords().

cpdf_set_subject

cpdf_set_subject -- pdf 문서에서 subject 필드를 설정한다.

Description

void cpdf_set_subject(string subject);

The cpdf_set_subject() function sets the subject of a pdf document.

See also cpdf_set_title(), cpdf_set_creator(), cpdf_set_keywords().

cpdf_set_keywords

cpdf_set_keywords -- pdf 문서에서 keywords 필드를 설정한다.

Description

void cpdf_set_keywords(string keywords);

The cpdf_set_keywords() function sets the keywords of a pdf document.

See also cpdf_set_title(), cpdf_set_creator(), cpdf_set_subject().

cpdf_open

cpdf_open -- 새 pdf 문서를 연다.

Description

int cpdf_open(int compression, string filename);

The cpdf_open() function opens a new pdf document. The first parameter turns document compression on if it is unequal to 0. The second optional parameter sets the file in which the document is written. If it is omitted the document is created in memory and can either be written into a file with the cpdf_save_to_file() or written to standard output with cpdf_output_buffer().

Note: The return value will be needed in futher versions of ClibPDF as the first parameter in all other functions which are writing to the pdf document.

The ClibPDF library takes the filename "-" as a synonym for stdout. If PHP is compiled as an apache module this will not work because the way ClibPDF outputs to stdout does not work with apache. You can solve this problem by skipping the filename and using cpdf_output_buffer() to output the pdf document.

See also cpdf_close(), cpdf_output_buffer().

cpdf_close

cpdf_close -- pdf 문서를 닫는다.

Description

void cpdf_close(int pdf document);

The cpdf_close() function closes the pdf document. This should be the last function even after cpdf_finalize(), cpdf_output_buffer() and cpdf_save_to_file().

See also cpdf_open().

cpdf_page_init

cpdf_page_init -- 새 page를 시작한다.

Description

void cpdf_page_init(int pdf document, int page number, int orientation, double height, double width, double unit);

The cpdf_page_init() function starts a new page with height height and width width. The page has number page number and orientation orientation. orientation can be 0 for portrait and 1 for landscape. The last optional parameter unit sets the unit for the koordinate system. The value should be the number of postscript points per unit. Since one inch is equal to 72 points, a value of 72 would set the unit to one inch. The default is also 72.

See also cpdf_set_current_page().

cpdf_finalize_page

cpdf_finalize_page -- page를 끝낸다.

Description

void cpdf_finalize_page(int pdf document, int page number);

The cpdf_finalize_page() function ends the page with page number page number. This function is only for saving memory. A finalized page takes less memory but cannot be modified anymore.

See also cpdf_page_init().

cpdf_finalize

cpdf_finalize -- 문서를 끝낸다.

Description

void cpdf_finalize(int pdf document);

The cpdf_finalize() function ends the document. You still have to call cpdf_close().

See also cpdf_close().

cpdf_output_buffer

cpdf_output_buffer -- 메모리 버퍼의 PDF 문서를 출력한다.

Description

void cpdf_output_buffer(int pdf document);

The cpdf_output_buffer() function outputs the pdf document to stdout. The document has to be created in memory which is the case if cpdf_open() has been called with no filename parameter.

See also cpdf_open().

cpdf_save_to_file

cpdf_save_to_file -- PDF문서를 파일로 출력한다.

Description

void cpdf_save_to_file(int pdf document, string filename);

The cpdf_save_to_file() function outputs the pdf document into a file if it has been created in memory. This function is not needed if the pdf document has been open by specifying a filename as a parameter of cpdf_open().

See also cpdf_output_buffer(), cpdf_open().

cpdf_set_current_page

cpdf_set_current_page -- 현재 page를 설정한다.

Description

void cpdf_set_current_page(int pdf document, int page number);

The cpdf_set_current_page() function set the page on which all operations are performed. One can switch between pages until a page is finished with cpdf_finalize_page().

See also cpdf_finalize_page().

cpdf_begin_text

cpdf_begin_text -- text section을 시작한다.

Description

void cpdf_begin_text(int pdf document);

The cpdf_begin_text() function starts a text section. It must be ended with cpdf_end_text().

Example 1. Text output <?php cpdf_begin_text($pdf); cpdf_set_font($pdf, 16, "Helvetica", 4); cpdf_text($pdf, 100, 100, "Some text"); cpdf_end_text($pdf) ?>

See also cpdf_end_text().

cpdf_end_text

cpdf_end_text -- text section을 끝낸다.

Description

void cpdf_end_text(int pdf document);

The cpdf_end_text() function ends a text section which was started with cpdf_begin_text().

Example 1. Text output <?php cpdf_begin_text($pdf); cpdf_set_font($pdf, 16, "Helvetica", 4); cpdf_text($pdf, 100, 100, "Some text"); cpdf_end_text($pdf) ?>

See also cpdf_begin_text().

cpdf_show

cpdf_show -- 현재 위치에 text를 출력한다.

Description

void cpdf_show(int pdf document, string text);

The cpdf_show() function outputs the string in text at the current position.

See also cpdf_text(), cpdf_begin_text(), cpdf_end_text().

cpdf_show_xy

cpdf_show_xy -- 지정한 위치에 text를 출력한다.

Description

void cpdf_show_xy(int pdf document, string text, double x-koor, double y-koor, int mode);

The cpdf_show_xy() function outputs the string text at position with coordinates (x-koor, y-koor). The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

Note: The function cpdf_show_xy() is identical to cpdf_text().

See also cpdf_text().

cpdf_text

cpdf_text -- 지정된 파라메터대로 text를 출력한다.

Description

void cpdf_text(int pdf document, string text, double x-koor, double y-koor, int mode, double orientation, int alignmode);

The cpdf_text() function outputs the string text at position with coordinates (x-koor, y-koor). The optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit. The optional parameter orientation is the rotation of the text in degree. The optional parameter alignmode determines how the text is align. See the ClibPDF documentation for possible values.

See also cpdf_show_xy().

cpdf_set_font

cpdf_set_font -- 현재 사용할 폰트 모양과 크기를 선택한다.

Description

The cpdf_set_font() function sets the the current font face, font size and encoding. Currently only the standard postscript fonts are supported. The last parameter encoding can take the following values: "MacRomanEncoding", "MacExpertEncoding", "WinAnsiEncoding", and "NULL". "NULL" stands for the font's built-in encoding. See the ClibPDF Manual for more information, especially how to support asian fonts.

cpdf_set_leading

cpdf_set_leading -- text 줄간격을 지정한다.

Description

void cpdf_set leading(int pdf document, double distance);

The cpdf_set_leading() function sets the distance between text lines. This will be used if text is output by cpdf_continue_text().

See also cpdf_continue_text().

cpdf_set_text_rendering

cpdf_set_text_rendering -- text의 rendering 방법을 결정한다.

Description

void cpdf_set_text_rendering(int pdf document, int mode);

The cpdf_set_text_rendering() function determines how text is rendered. The possible values for mode are 0=fill text, 1=stroke text, 2=fill and stroke text, 3=invisible, 4=fill text and add it to cliping path, 5=stroke text and add it to clipping path, 6=fill and stroke text and add it to cliping path, 7=add it to clipping path.

cpdf_set_horiz_scaling

cpdf_set_horiz_scaling -- text의 수평 확대값을 정한다.

Description

void cpdf_set_horiz_scaling(int pdf document, double scale);

The cpdf_set_horiz_scaling() function sets the horizontal scaling to scale percent.

cpdf_set_text_rise

cpdf_set_text_rise -- text를 솟아 오른 모양(rise)으로 만든다.

Description

void cpdf_set_text_rise(int pdf document, double value);

The cpdf_set_text_rise() function sets the text rising to value units.

cpdf_set_text_matrix

cpdf_set_text_matrix -- text를 행열의 형태로 설정한다.

Description

void cpdf_set_text_matrix(int pdf document, array matrix);

The cpdf_set_text_matrix() function sets a matrix which describes a transformation applied on the current text font.

cpdf_set_text_pos

cpdf_set_text_pos -- text 위치를 정한다.

Description

void cpdf_set_text_pos(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_set_text_pos() function sets the position of text for the next cpdf_show() function call. The optional parameter mode

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_show(), cpdf_text().

cpdf_set_char_spacing

cpdf_set_char_spacing -- 글자간의 간격을 정한다.

Description

void cpdf_set_char_spacing(int pdf document, double space);

The cpdf_set_char_spacing() function sets the spacing between characters.

See also cpdf_set_word_spacing(), cpdf_set_leading().

cpdf_set_word_spacing

cpdf_set_word_spacing -- 단어간의 간격을 정한다.

Description

void cpdf_set_word_spacing(int pdf document, double space);

The cpdf_set_word_spacing() function sets the spacing between words.

See also cpdf_set_char_spacing(), cpdf_set_leading().

cpdf_continue_text

cpdf_continue_text -- 다음줄에 text를 출력한다.

Description

void cpdf_continue_text(int pdf document, string text);

The cpdf_continue_text() function outputs the string in text in the next line.

See also cpdf_show_xy(), cpdf_text(), cpdf_set_leading(), cpdf_set_text_pos().

cpdf_stringwidth

cpdf_stringwidth -- 현재 폰트를 사용한 해당 text의 넓이를 반환한다.

Description

double cpdf_stringwidth(int pdf document, string text);

The cpdf_stringwidth() function returns the width of the string in text. It requires a font to be set before.

See also cpdf_set_font().

cpdf_save

cpdf_save -- 현재의 환경을 저장한다.

Description

void cpdf_save(int pdf document);

The cpdf_save() function saves the current enviroment. It works like the postscript command gsave. Very useful if you want to translate or rotate an object without effecting other objects.

See also cpdf_restore().

cpdf_restore

cpdf_restore -- 이전에 저장했던 환경으로 재설정한다.

Description

void cpdf_restore(int pdf document);

The cpdf_restore() function restores the enviroment saved with cpdf_save(). It works like the postscript command grestore. Very useful if you want to translate or rotate an object without effecting other objects.

Example 1. Save/Restore <?php cpdf_save($pdf); // do all kinds of rotations, transformations, ... cpdf_restore($pdf) ?>

See also cpdf_save().

cpdf_translate

cpdf_translate -- 좌표 시스템의 원점을 지정한다.

Description

void cpdf_translate(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_translate() function set the origin of coordinate system to the point (x-koor, y-koor).

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

cpdf_scale

cpdf_scale -- 화대/축소값을 정한다.

Description

void cpdf_scale(int pdf document, double x-scale, double y-scale);

The cpdf_scale() function set the scaling factor in both directions.

cpdf_rotate

cpdf_rotate -- 회전 정도(rotation )를 정한다.

Description

void cpdf_rotate(int pdf document, double angle);

The cpdf_rotate() function set the rotation in degress to angle.

cpdf_setflat

cpdf_setflat -- flatness를 정한다.

Description

void cpdf_setflat(int pdf document, double value);

The cpdf_setflat() function set the flatness to a value between 0 and 100.

cpdf_setlinejoin

cpdf_setlinejoin -- linejoin 파라메터를 설정한다.

Description

void cpdf_setlinejoin(int pdf document, long value);

The cpdf_setlinejoin() function set the linejoin parameter between a value of 0 and 2. 0 = miter, 1 = round, 2 = bevel.

cpdf_setlinecap

cpdf_setlinecap -- linecap 파라메터를 설정한다.

Description

void cpdf_setlinecap(int pdf document, int value);

The cpdf_setlinecap() function set the linecap parameter between a value of 0 and 2. 0 = butt end, 1 = round, 2 = projecting square.

cpdf_setmiterlimit

cpdf_setmiterlimit -- miter 한계를 설정한다.

Description

void cpdf_setmiterlimit(int pdf document, double value);

The cpdf_setmiterlimit() function set the miter limit to a value greater or equal than 1.

cpdf_setlinewidth

cpdf_setlinewidth -- 줄의 두께를 정한다.

Description

void cpdf_setlinewidth(int pdf document, double width);

The cpdf_setlinewidth() function set the line width to width.

cpdf_setdash

cpdf_setdash -- 선이나 점선의 형태를 정한다.

Description

void cpdf_setdash(int pdf document, double white, double black);

The cpdf_setdash() function set the dash pattern white white units and black black units. If both are 0 a solid line is set.

cpdf_moveto

cpdf_moveto -- 현재 위치를 정한다.

Description

void cpdf_moveto(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_moveto() function set the current point to the coordinates x-koor and y-koor.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

cpdf_rmoveto

cpdf_rmoveto -- 현재 위치를 정한다. (현재 위치에서 상대적인 값을 준다.)

Description

void cpdf_rmoveto(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_rmoveto() function set the current point relative to the coordinates x-koor and y-koor.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_moveto().

cpdf_curveto

cpdf_curveto -- 곡선을 그린다.

Description

void cpdf_curveto(int pdf document, double x1, double y1, double x2, double y2, double x3, double y3, int mode);

The cpdf_curveto() function draws a Bezier curve from the current point to the point (x3, y3) using (x1, y1) and (x2, y2) as control points.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_moveto(), cpdf_rmoveto(), cpdf_rlineto(), cpdf_lineto().

cpdf_lineto

cpdf_lineto -- 직선을 그린다.

Description

void cpdf_lineto(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_lineto() function draws a line from the current point to the point with coordinates (x-koor, y-koor).

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_moveto(), cpdf_rmoveto(), cpdf_curveto().

cpdf_rlineto

cpdf_rlineto -- 직선을 그린다. (현재 위치에서 상대적인 위치값으로 그린다.)

Description

void cpdf_rlineto(int pdf document, double x-koor, double y-koor, int mode);

The cpdf_rlineto() function draws a line from the current point to the relative point with coordinates (x-koor, y-koor).

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_moveto(), cpdf_rmoveto(), cpdf_curveto().

cpdf_circle

cpdf_circle -- 윈을 그린다.

Description

void cpdf_circle(int pdf document, double x-koor, double y-koor, double radius, int mode);

The cpdf_circle() function draws a circle with center at point (x-koor, y-koor) and radius radius.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_arc().

cpdf_arc

cpdf_arc -- 원호를 그린다.

Description

void cpdf_arc(int pdf document, double x-koor, double y-koor, double radius, double start, double end, int mode);

The cpdf_arc() function draws an arc with center at point (x-koor, y-koor) and radius radius, starting at angle start and ending at angle end.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

See also cpdf_circle().

cpdf_rect

cpdf_rect -- 직사각형을 그린다.

Description

void cpdf_rect(int pdf document, double x-koor, double y-koor, double width, double height, int mode);

The cpdf_rect() function draws a rectangle with its lower left corner at point (x-koor, y-koor). This width is set to widgth. This height is set to height.

The last optional parameter determines the unit length. If is 0 or omitted the default unit as specified for the page is used. Otherwise the koodinates are measured in postscript points disregarding the current unit.

cpdf_closepath

cpdf_closepath -- path를 닫는다.

Description

void cpdf_closepath(int pdf document);

The cpdf_closepath() function closes the current path.

cpdf_stroke

cpdf_stroke -- path를 따라 선을 그린다.

Description

void cpdf_stroke(int pdf document);

The cpdf_stroke() function draws a line along current path.

See also cpdf_closepath(), cpdf_closepath_stroke().

cpdf_closepath_stroke

cpdf_closepath_stroke -- path를 닫고 해당 path에 따라 선을 그린다.

Description

void cpdf_closepath_stroke(int pdf document);

The cpdf_closepath_stroke() function is a combination of cpdf_closepath() and cpdf_stroke(). Than clears the path.

See also cpdf_closepath(), cpdf_stroke().

cpdf_fill

cpdf_fill -- 현재 path의 내부를 채운다.

Description

void cpdf_fill(int pdf document);

The cpdf_fill() function fills the interior of the current path with the current fill color.

See also cpdf_closepath(), cpdf_stroke(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_fill_stroke

cpdf_fill_stroke -- 현재 path를 채우고 선을 그린다.

Description

void cpdf_fill_stroke(int pdf document);

The cpdf_fill_stroke() function fills the interior of the current path with the current fill color and draws current path.

See also cpdf_closepath(), cpdf_stroke(), cpdf_fill(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_closepath_fill_stroke

cpdf_closepath_fill_stroke -- 현재 path를 닫은 후, 채우고 선을 그린다.

Description

void cpdf_closepath_fill_stroke(int pdf document);

The cpdf_closepath_fill_stroke() function closes, fills the interior of the current path with the current fill color and draws current path.

See also cpdf_closepath(), cpdf_stroke(), cpdf_fill(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_clip

cpdf_clip -- 현재 path를 따낸다.(clip)

Description

void cpdf_clip(int pdf document);

The cpdf_clip() function clips all drawing to the current path.

cpdf_setgray_fill

cpdf_setgray_fill -- 채우는 색을 흑백값으로 정한다.

Description

void cpdf_setgray_fill(int pdf document, double value);

The cpdf_setgray_fill() function sets the current gray value to fill a path.

See also cpdf_setrgbcolor_fill().

cpdf_setgray_stroke

cpdf_setgray_stroke -- (선이나 글자를) 그리는 색을 흑백값으로 정한다.

Description

void cpdf_setgray_stroke(int pdf document, double gray value);

The cpdf_setgray_stroke() function sets the current drawing color to the given gray value.

See also cpdf_setrgbcolor_stroke().

cpdf_setgray

cpdf_setgray -- 채우는 색과 그리는 색의 흑백값 정도를 정한다.

Description

void cpdf_setgray(int pdf document, double gray value);

The cpdf_setgray_stroke() function sets the current drawing and filling color to the given gray value.

See also cpdf_setrgbcolor_stroke(), cpdf_setrgbcolor_fill().

cpdf_setrgbcolor_fill

cpdf_setrgbcolor_fill -- 채우는 색을 rgb color 값으로 정한다.

Description

void cpdf_setrgbcolor_fill(int pdf document, double red value, double green value, double blue value);

The cpdf_setrgbcolor_fill() function sets the current rgb color value to fill a path.

See also cpdf_setrgbcolor_fill().

cpdf_setrgbcolor_stroke

cpdf_setrgbcolor_stroke -- 그리는 색을 rgb color 값으로 정한다.

Description

void cpdf_setrgbcolor_stroke(int pdf document, double red value, double green value, double blue value);

The cpdf_setrgbcolor_stroke() function sets the current drawing color to the given rgb color value.

See also cpdf_setrgbcolor_stroke().

cpdf_setrgbcolor

cpdf_setrgbcolor -- 채우는 색과 그리는 색의 rgb color 값을 정한다.

Description

void cpdf_setrgbcolor(int pdf document, double red value, double green value, double blue value);

The cpdf_setrgbcolor_stroke() function sets the current drawing and filling color to the given rgb color value.

See also cpdf_setrgbcolor_stroke(), cpdf_setrgbcolor_fill().

cpdf_add_outline

cpdf_add_outline -- 현재 page에 bookmark를 추가한다.

Description

void cpdf_add_outline(int pdf document, string text);

The cpdf_add_outline() function adds a bookmark with text text that points to the current page.

Example 1. Adding a page outline <?php $cpdf = cpdf_open(0); cpdf_page_init($cpdf, 1, 0, 595, 842); cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1"); // ... // some drawing // ... cpdf_finalize($cpdf); Header("Content-type: application/pdf"); cpdf_output_buffer($cpdf); cpdf_close($cpdf); ?>

cpdf_set_page_animation

cpdf_set_page_animation -- page간에 넘어가는 방법을 정한다.

Description

void cpdf_set_page_animation(int pdf document, int transition, double duration);

The cpdf_set_page_animation() function set the transition between following pages.

The value of transition can be

0 for none,

1 for two lines sweeping across the screen reveal the page,

2 for multiple lines sweeping across the screen reveal the page,

3 for a box reveals the page,

4 for a single line sweeping across the screen reveals the page,

5 for the old page dissolves to reveal the page,

6 for the dissolve effect moves from one screen edge to another,

7 for the old page is simply replaced by the new page (default)