cvs: phpdoc /kr/features connection-handling.xml persistent-connections.xml remote-files.xml

From: Date: Wed, 10 Jan 2001 05:49:22 +0000
Subject: cvs: phpdoc /kr/features connection-handling.xml persistent-connections.xml remote-files.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333528@lists.php.net to get a copy of this message
regina Tue Jan 9 21:49:22 2001 EDT Modified files: /phpdoc/kr/features connection-handling.xml persistent-connections.xml remote-files.xml Log:

Index: phpdoc/kr/features/connection-handling.xml diff -u phpdoc/kr/features/connection-handling.xml:1.2 phpdoc/kr/features/connection-handling.xml:1.3 --- phpdoc/kr/features/connection-handling.xml:1.2 Tue Jan 9 16:39:21 2001 +++ phpdoc/kr/features/connection-handling.xml Tue Jan 9 21:49:22 2001 @@ -1,13 +1,12 @@ - <chapter id="features.connection-handling"> + <chapter id="features.connection-handling"> <title>Connection handling</title> <note> - <para>The following applies to 3.0.7 and later.</para> + <para>이 기능은 PHP version 3.0.7 이후부터 적용된 것들이다.</para> </note> <para> - Internally in PHP a connection status is maintained. There are 3 - possible states: + 내부적으로 PHP는 연결의 상태를 다음 3가지중 하나로 설정한다. : <itemizedlist> <listitem><simpara>0 - NORMAL</simpara></listitem> <listitem><simpara>1 - ABORTED</simpara></listitem> @@ -16,60 +15,55 @@ </para> <simpara> - When a PHP script is running normally the NORMAL state, is active. - If the remote client disconnects the ABORTED state flag is - turned on. A remote client disconnect is usually caused by the - user hitting his STOP button. If the PHP-imposed time limit (see - <function>set_time_limit</function>) is hit, the TIMEOUT state flag - is turned on.</simpara> + PHP 스크립트가 일반적으로 실행되고 있을 때는 NORMAL 상태가 active된다. + 만약 원격 클라이언트가 연결을 끊게되면 ABORTED 상태 flag가 켜지게 된다. + 보통 클라이언트가 연결을 끊는 것은 사용자가 STOP 버튼을 눌렀을 때 일어난다. + 만약 PHP가 설정한 시간 제한에 (<function>set_time_limit</function>을 보라) 걸리게 되면 + TIMEOUT 상태 flag가 켜지게 된다. + </simpara> <simpara> - You can decide whether or not you want a client disconnect to cause - your script to be aborted. Sometimes it is handy to always have your - scripts run to completion even if there is no remote browser receiving - the output. The default behaviour is however for your script to be - aborted when the remote client disconnects. This behaviour can be - set via the ignore_user_abort php3.ini directive as well as through - the corresponding php3_ignore_user_abort Apache .conf directive or - with the <function>ignore_user_abort</function> function. If you do - not tell PHP to ignore a user abort and the user aborts, your script - will terminate. The one exception is if you have registered a shutdown - function using <function>register_shutdown_function</function>. With a - shutdown function, when the remote user hits his STOP button, the - next time your script tries to output something PHP will detect that - the connection has been aborted and the shutdown function is called. - This shutdown function will also get called at the end of your script - terminating normally, so to do something different in case of a client - diconnect you can use the <function>connection_aborted</function> - function. This function will return true if the connection was - aborted.</simpara> + 여러분은 클라이언트가 연결을 끊었을 때 스크립트가 수행을 중단할 것인가 아닌가를 결정하여야 한다. + 때때로 원격 브라우저가 어떤 결과도 받아들이지 않더라도 스크립트를 끝까지 실행하는 것이 편리할 때가 많다. + 기본 동작은 클라이언트가 연결을 끊으면 스크립트도 중단되는 것이다. + 이 동작은 ignore_user_abort라는 php3.ini 지시자(directive)나, + php3_ignore_user_abort라는 Apache의 .conf의 지시자로 설정이 가능하고, + <function>ignore_user_abort</function> 함수를 사용하여 설정할 수도 있다. + 만약 PHP에게 사용자가 내린 중지 명령을 무시하라고 말해주지 않았다면, + 사용자의 중지 신호는 여러분의 스크립트를 종료시킨다. + 단, <function>register_shutdown_function</function>을 사용하여 + shutdown 함수를 등록해 놓은 경우는 예외가 된다. + shutdown 함수를 사용하면, 사용자가 STOP버튼을 눌렀을 때, + 여러분의 스크립트는 남은 출력을 하려고 하고, + PHP는 연결이 중단되었음을 인지하여 shutdown 함수를 호출하게 된다. + shutdown 함수는 여러분의 스크립트가 정상적으로 종료되었을 때도 호출 된다. + 만약 여기서 클라이언트의 연결 중단 때와 일반적인 종료시에 다른 동작을 원한다면 + <function>connection_aborted</function> 함수를 사용하면 된다. + 이 함수는 연결이 중단되었다면 true를 반환한다. + </simpara> <simpara> - Your script can also be terminated by the built-in script timer. - The default timeout is 30 seconds. It can be changed using - the max_execution_time php3.ini directive or the corresponding - php3_max_execution_time Apache .conf directive as well as with - the <function>set_time_limit</function> function. When the timer - expires the script will be aborted and as with the above client - disconnect case, if a shutdown function has been registered it will - be called. Within this shutdown function you can check to see if - a timeout caused the shutdown function to be called by calling the - <function>connection_timeout</function> function. This function will - return true if a timeout caused the shutdown function to be called.</simpara> - + 스크립트는 내장된 타이머에 의해 종료될 수 있다. + 기본 timeout 시간은 30초로 되어 있다. + 이것은 max_execution_time이라는 php3.ini 지시자(directive)나, + 동일한 내용의 php3_max_execution_time이라는 Apache의 .conf 지시자에 의해 + 다르게 설정이 가능하고 <function>set_time_limit</function> 함수를 사용하여 설정할 수도 있다. + 설정한 시간이 경과하면 스크립트는 자동으로 중단되고, + 이 스크립트는 위에 설명한 클라이언트와의 연결이 종료된 것처럼 동작한다. + 따라서 shutdown 함수가 등록되어 있다면 이 함수가 실행된다. + shutdown 함수내에서 이 함수가 timeout에 의해 호출된 것인가를 판단하려면 + <function>connection_timeout</function> 함수를 사용하면 된다. + 이 함수는 timeout에 의해 shutdown 함수가 호출되었다면 true를 반환한다. + </simpara> <simpara> - One thing to note is that both the ABORTED and the TIMEOUT states - can be active at the same time. This is possible if you tell - PHP to ignore user aborts. PHP will still note the fact that - a user may have broken the connection, but the script will keep - running. If it then hits the time limit it will be aborted and - your shutdown function, if any, will be called. At this point - you will find that <function>connection_timeout</function> - and <function>connection_aborted</function> return true. - You can also check both states in a single call by using the - <function>connection_status</function>. This function returns a - bitfield of the active states. So, if both states are active it - would return 3, for example.</simpara> + 한가지 유의할 사항은 ABORTED와 TIMEOUT 상태는 두 개가 동시에 active될 수 있다는 것이다. + 이것은 PHP가 사용자 중단을 무시하도록 설정해 놓았을 때 생길 수 있다. + 또 다른 경우는 사용자가 연결을 끊지는 않았지만 연결에 어떤 문제가 생겨 연결이 망가진 경우로, + 이런 경우에 스크립트는 계속실행되고, 시간 제한에 걸려 스크립트의 수행이 중단되고 shutdown 함수가 호출되면, <function>connection_timeout</function>과 <function>connection_aborted</function>함수 모두 true를 반환하게 된다. + 여러분은 <function>connection_status</function> 함수를 사용하여 두가지 상태 모두를 검사할 수 있다. + 함수는 각 상태에 대한 정보를 bit단위로 가지고 있다. + 를들어 위와같이 ABORT와 TIMEOUT 두 개의 상태가 모두 active되어 있다면 이 함수는 3을 반환한다. + </simpara> </chapter> Index: phpdoc/kr/features/persistent-connections.xml diff -u phpdoc/kr/features/persistent-connections.xml:1.2 phpdoc/kr/features/persistent-connections.xml:1.3 --- phpdoc/kr/features/persistent-connections.xml:1.2 Tue Jan 9 16:39:21 2001 +++ phpdoc/kr/features/persistent-connections.xml Tue Jan 9 21:49:22 2001 @@ -1,91 +1,76 @@ - <chapter id="features.persistent-connections"> - <title>Persistent Database Connections</title> + <chapter id="features.persistent-connections"> + <title>영구적인 데이터베이스 접속 (Persistent database connections)</title> <simpara> - Persistent connections are SQL links that do not close when the - execution of your script ends. When a persistent connection is - requested, PHP checks if there's already an identical persistent - connection (that remained open from earlier) - and if it exists, it - uses it. If it does not exist, it creates the link. An 'identical' - connection is a connection that was opened to the same host, with - the same username and the same password (where applicable). - </simpara> - <simpara> - People who aren't thoroughly familiar with the way web servers work - and distribute the load may mistake persistent connects for what - they're not. In particular, they do <emphasis>not</emphasis> give - you an ability to open 'user sessions' on the same SQL link, they - do <emphasis>not</emphasis> give you an ability to build up a - transaction efficently, and they don't do a whole lot of other - things. In fact, to be extremely clear about the subject, - persistent connections don't give you <emphasis>any</emphasis> - functionality that wasn't possible with their non-persistent - brothers. + 영구적인 접속(Persistent connection)은 여러분의 스크립트가 종료되어도 + SQL link를 닫지 않는 접속을 말한다. 영구적인 접속이 요청되면, + PHP는 기존의 (이전에 열어 두었던) 동일한(identical) 영구적인 접속이 있는가를 검사한다. + 만약 있다면 기존의 것을 사용하고, 없다면 새로운 link를 만든다. + '동일한' 접속이란 같은 호스트에 같은 사용자명과 같은 암호를 사용한 접속을 말한다. </simpara> <simpara> - Why? + 가끔 웹서버의 작동과 작업의 할당에 대해 잘 알고 있지 못한 사람들은 + 영구적인 접속이 사실은 별 것 아니라고 오해하기도 한다. + 특히, 영구적인 접속이 동일한 SQL link에서 'user sessions'를 여는데 별 나을 것도 없다던가, transaction을 효율적으로 처리하는 것도 아니라다던가, 혹은 다른 어떤 + 특별한 것을 하는 것도 아니라고 한다. 사실, 이런 말들에 대해 명백히 말하자면, + 영구적인 접속은 비영구적인 접속에 비해 어떠한 기능적인 향상도 주지 못한다. + </simpara> + <simpara> + 왜? </simpara> <simpara> - This has to do with the way web servers work. There are three ways - in which your web server can utilize PHP to generate web pages. + 이것은 웹서버의 동작 방식에 따라 다른 효과를 낸다. + 여러분의 웹서버가 웹 페이지를 만들기위해 PHP를 이용하는데는 3가지 방법이 있다. </simpara> <simpara> - The first method is to use PHP as a CGI "wrapper". When run this - way, an instance of the PHP interpreter is created and destroyed - for every page request (for a PHP page) to your web server. - Because it is destroyed after every request, any resources that it - acquires (such as a link to an SQL database server) are closed when - it is destroyed. In this case, you do not gain anything from trying - to use persistent connections -- they simply don't persist. - </simpara> - <simpara> - The second, and most popular, method is to run PHP as a module in a - multiprocess web server, which currently only includes Apache. A - multiprocess server typically has one process (the parent) which - coordinates a set of processes (its children) who actually do the - work of serving up web pages. When each request comes in from a - client, it is handed off to one of the children that is not already - serving another client. This means that when the same client makes - a second request to the server, it may be serviced by a different - child process than the first time. What a persistent connection - does for you in this case it make it so each child process only - needs to connect to your SQL server the first time that it serves a - page that makes us of such a connection. When another page then - requires a connection to the SQL server, it can reuse the - connection that child established earlier. - </simpara> - <simpara> - The last method is to use PHP as a plug-in for a multithreaded web - server. Currently this is only theoretical -- PHP does not yet work - as a plug-in for any multithreaded web servers. Work is progressing - on support for ISAPI, WSAPI, and NSAPI (on Windows), which will all - allow PHP to be used as a plug-in on multithreaded servers like - Netscape FastTrack, Microsoft's Internet Information Server (IIS), - and O'Reilly's WebSite Pro. When this happens, the behavior will be - essentially the same as for the multiprocess model described - before. - </simpara> - <simpara> - If persistent connections don't have any added functionality, what - are they good for? - </simpara> - <simpara> - The answer here is extremely simple -- efficiency. Persistent - connections are good if the overhead to create a link to your SQL - server is high. Whether or not this overhead is really high depends - on many factors. Like, what kind of database it is, whether or not - it sits on the same computer on which your web server sits, how - loaded the machine the SQL server sits on is and so forth. The - bottom line is that if that connection overhead is high, persistent - connections help you considerably. They cause the child process to - simply connect only once for its entire lifespan, instead of every - time it processes a page that requires connecting to the SQL - server. This means that for every child that opened a persistent - connection will have its own open persistent connection to the - server. For example, if you had 20 different child processes that - ran a script that made a persistent connection to your SQL server, - you'd have 20 different connections to the SQL server, one from - each child. + 첫 번째 방법은 PHP를 CGI "wrapper"이 형태로 사용하는 것이다. + 이 방법의 경우, 웹서버에 매 PHP 페이지가 요구될 때 마다, + PHP 인터프리터의 실행이 만들어지고 종료된다. + 따라서 매 요구가 종료될 때마다 인터프리터의 실행이 종료되므로, + 실행 중 만들었던 (SQL link를 포함한) 모든 자원은 실행 종료와 더불어 해제된다. + 이 경우 영구적입 접속을 사용하여 어떤 이득도 얻을 수 없다. + 다르게 말하면 이 경우는 영구적인 접속을 해도 영구적이 아니다. + </simpara> + <simpara> + 두 번째 방법은 가장 대중적인 방법인데, + PHP를 다중프로세스(multiprocess) 웹서버의 모듈로 사용하는 것이다. + (현재는 Apache가 유일하다.) 다중프로세스 서버는 보통 한 개의 부모(parent) 프로세스와, + 이와 유기적으로 연결되어 웹 페이지를 실제로 만드는 작업을 하는 여러개의 + 자식(child) 프로세스들을 가지고 있다. 클라이언트로부터 들어오는 개별 요구는 + 다른 클라이언트의 요구를 처리하고 있지 않고 놀고있는 자식 프로세스로 넘겨진다. + 이것은 동일한 클라이언트가 서버에 두 번째 요구를 보낼 때, + 보통 처음과 다른 자식 프로세스에서 처리된다는 것을 의미한다. + 이 경우 영구적인 접속을 사용하면 각각의 자식 프로세스들은 + 자신이 처음 요구받았을 때 SQL 서버에 접속하게 된다. + 다른 페이지에서 SQL 서버에 접속 요구시는 이전에 만들어진 접속을 다시 사용하게 된다. + </simpara> + <simpara> + 마지막 방법은 PHP를 멀티쓰레드(multithreaded) 웹서버의 플러그-인의 + 형태로 작동시키는 것인데, 현재 이방법은 이론적으로만 존재하고, + 실제로 만들어 진 것은 없다. ISAPI, WSAPI, NSAPI (Windows에서) 등의 + 방법을 사용하여 Netscape FastTrack, Microsoft's Internet Information Server (IIS), + O'Reilly's WebSite Pro 등의 멀티쓰레드 웹서버에서 PHP를 플러그-인으로 + 동작시키려는 작업이 현재 진행중이다. 이 경우 기본 동작은 위에서 언급한 + 다중프로세스 모델과 동일하게 동작한다. + </simpara> + <simpara> + 영구적인 접속이 실제로 어떠한 기능적인 향상도 주지 못한다면, + 이것을 사용해 어떤 이점이 있나요? + </simpara> + <simpara> + 이것에 대한 간단한 답은 효율성이다. + 영구적인 접속은 SQL 서버와의 link를 만드는 것에 따른 overhead가 클 경우에 유용하다. + 이 overhead는 많은 요인에 따라 커지기도 하고 작아지기도 한다. + 어떤 종류의 데이터베이스인가? 웹서버와 같은 컴퓨터에 데이터베이스 서버가 있는가? + SQL 서버가 어떻게 사용되고 있는가? 등에 따라 크게 달라진다. + 접속에 따른 overhead가 클 경우에 영구적인 접속은 여러분에게 + 적지 않은 도움을 줄 것이다. 이것은 자식 process에서 SQL 서버에 + 접속을 요청할 때 마다 접속을 만드는 대신, 이 프로세스가 종료될 때 까지 + 살아있는 한 개의 접속 만을 사용한다. 이것은 모든 영구적인 접속을 사용한 + 프로세스는, 그에 해당하는 한 대의 영구적인 접속을 가지고 있다는 것을 의미한다. + 예를 들어 SQL 서버에 대하여 영구적인 접속을 사용하는 스크립트를 + 실행하였던 20개의 다른 자식 프로세스가 있다면, + 아마도 각각의 자식 프로세스에대해 1개씩, 20개의 SQL 접속이 있을 것이다. </simpara> <simpara> Note, however, that this can have some drawbacks if you are using a @@ -99,13 +84,11 @@ information on handling abandoned or idle connections. </simpara> <simpara> - An important summary. Persistent connections were designed to have - one-to-one mapping to regular connections. That means that you - should <emphasis>always</emphasis> be able to replace persistent - connections with non-persistent connections, and it won't change - the way your script behaves. It <emphasis>may</emphasis> (and - probably will) change the efficiency of the script, but not its - behavior! + 중요한 언급 한가지! + 영구적인 접속은 일반적인 접속에 일대일로 대응되도록 설계되었다. + 이것은 스크립트의 다른 부분은 그대로 두고, + 언제라도 비영구적인 연결을 영구적인 연결로 대치할 수 있다는 것을 의미한다. + 이것으로 여러분은 아마도 스크립트의 효율을 향상시킬 수도 있을 것이다. </simpara> </chapter> Index: phpdoc/kr/features/remote-files.xml diff -u phpdoc/kr/features/remote-files.xml:1.2 phpdoc/kr/features/remote-files.xml:1.3 --- phpdoc/kr/features/remote-files.xml:1.2 Tue Jan 9 16:39:21 2001 +++ phpdoc/kr/features/remote-files.xml Tue Jan 9 21:49:22 2001 @@ -1,29 +1,29 @@ - <chapter id="features.remote-files"> + <chapter id="features.remote-files"> <title>Using remote files</title> <para> - As long as support for the &quot;URL fopen wrapper&quot; is enabled when - you configure PHP (which it is unless you explicitly pass the - <option>--disable-url-fopen-wrapper</option> flag to configure (for versions - up to 4.0.3) or set <parameter>allow_url_fopen</parameter> to off in php.ini - (for newer versions), - you can use HTTP and FTP URLs with most functions that take a - filename as a parameter, including the <function>require</function> - and <function>include</function> statements. + 여러분이 PHP를 설정할 때 "URL fopen wrapper"를 enable로 설정하였다면 + (이 설정은 PHP 4.0.3 이하에서는 configure 스크립트에서 + <option>--disable-url-fopen-wrapper</option>로 명시하지 하거나, + 그 이후의 버전에서는 php.ini 파일에 <parameter>allow_url_fopen</parameter>을 + off로 설정하지 않으면 설정된다.), + 여러분은 파일이름을 파라메타로 가지는 대부분의 함수에 HTTP나 FTP URL을 + 파일이름으로 사용할 수 있다. 심지어 <function>require</function>와 + <function>include</function> 함수에도 사용이 가능하다. </para> <para> <note> <para> - You can't use remote files in <function>include</function> and - <function>require</function> statements on Windows. + 단, Windows환경의 <function>require</function>와 + <function>include</function> 함수에서는 사용할 수 없다. </para> </note> </para> <para> - For example, you can use this to open a file on a remote web server, - parse the output for the data you want, and then use that data in a - database query, or simply to output it in a style matching the rest - of your website. + 예를 들어, 이 기능을 사용하여 원격 웹 서버가 출력하는 내용을 파일로 열고, + 그 출력 내용에서 원하는 데이타를 분석하여, + 이 원하는 데이타로 데이타베이스 질의에 사용하거나, + 웹 사이트에 맞는 모양으로 변형 시켜 출력할 수 있다 </para> <para> <example> @@ -51,13 +51,12 @@ </example> </para> <para> - You can also write to files on an FTP as long you connect as a user - with the correct access rights, and the file doesn't exist already. - To connect as a user other than 'anonymous', you need to specify - the username (and possibly password) within the URL, such as - 'ftp://user:password@ftp.example.com/path/to/file'. (You can use the - same sort of syntax to access files via HTTP when they require Basic - authentication.) + 여러분은 해당 서버에 권한이 있는 사용자로 접속하고, + 해당 파일이 존재하지 않는다면, FTP를 이용한 파일에 쓸 수도 있다. + 'anonymous'가 아닌 사용자로 접속하려면, URL내에 username을 + (필요하다면 password도) 다음과 같이 명시해야 한다 : + 'ftp://user:password@ftp.example.com/path/to/file'. + (또한 HTTP에서 Basic authentication을 사용한 인증을 요구하는 경우에도 이와 같은 문법을 사용할 수 있다.) </para> <para> <example> @@ -81,11 +80,9 @@ <para> <note> <para> - You might get the idea from the example above to use this - technique to write to a remote log, but as mentioned above, you - can only write to a new file using the URL fopen() wrappers. To - do distributed logging like that, you should take a look at - <function>syslog</function>. + 여러분은 위의 예제를 보고, 이 테크닉을 사용하여 remote log를 작성할 수 있겠다고 생각할 수도 있다. + 그러나 위에 언급한대로 URL fopen() wrapper는 새 파일에만 쓸 수 있다. + 여러분이 원하는 대로 분산된 log를 하고 싶다면 <function>syslog</function>의 내용을 살펴보라. </para> </note> </para>
« previous php.doc (#969333528) next »