diff --git a/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml b/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml index 784620560d..cf98bb538b 100644 --- a/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml @@ -4267,17 +4267,17 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK setting up Apache - The open source Apache HTTP Server - is the most widely used web server. &os; does - not install this web server by default, but it can be installed - from the www/apache24 package or port. + The open source + Apache HTTP Server is the most widely + used web server. &os; does not install this web server by + default, but it can be installed from the + www/apache24 package or port. This section summarizes how to configure and start version 2.x of the Apache HTTP - Server on &os;. - For more detailed information about - Apache 2.X and its configuration - directives, refer to on &os;. For more detailed information + about Apache 2.X and its + configuration directives, refer to httpd.apache.org. @@ -4289,10 +4289,10 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK In &os;, the main Apache HTTP Server configuration file is installed as /usr/local/etc/apache2x/httpd.conf, - where x represents the version number. - This ASCII text file begins comment lines with a - #. The most frequently modified directives - are: + where x represents the version + number. This ASCII text file begins + comment lines with a #. The most + frequently modified directives are: @@ -4303,8 +4303,7 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK Apache installation. Binaries are stored in the bin and sbin subdirectories of the server - root and configuration files are stored in the - etc/apache2x subdirectory. @@ -4314,21 +4313,22 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK ServerAdmin you@example.com - Change this to the email address to receive problems with the - server. This address also appears on some + Change this to the email address to receive problems + with the server. This address also appears on some server-generated pages, such as error documents. - ServerName www.example.com:80 + ServerName + www.example.com:80 Allows an administrator to set a hostname which is sent back to clients for the server. For example, www can be used instead of the actual hostname. If the system does not have a - registeredDNS name, enter its + registered DNS name, enter its IP address instead. If the server will listen on an alternate report, change 80 to the alternate port @@ -4341,22 +4341,22 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK "/usr/local/www/apache2x/data" - The directory - where documents will be served from. By default, all - requests are taken from this directory, but symbolic - links and aliases may be used to point to other - locations. + The directory where documents will be served from. + By default, all requests are taken from this directory, + but symbolic links and aliases may be used to point to + other locations. - It is always a good idea to make a backup copy of the default - Apache configuration file before - making changes. When the configuration of - Apache is complete, save the - file and verify the configuration using apachectl. - Running apachectl configtest should return - Syntax OK. + It is always a good idea to make a backup copy of the + default Apache configuration file + before making changes. When the configuration of + Apache is complete, save the file + and verify the configuration using + apachectl. Running apachectl + configtest should return Syntax + OK. Apache starting or stopping @@ -4386,24 +4386,22 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK in a web browser, replacing localhost with the fully-qualified domain name of the machine running httpd. - The default web page that is - displayed is + The default web page that is displayed is /usr/local/www/apache24/data/index.html. The Apache configuration can be tested for errors after making subsequent configuration - changes while httpd is running using - the following - command: + changes while httpd is running using the + following command: &prompt.root; service apache24 configtest It is important to note that configtest is not an &man.rc.8; standard, - and should not be expected to work for all - startup scripts. - + and should not be expected to work for all startup + scripts. + @@ -4412,19 +4410,19 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSK Virtual hosting allows multiple websites to run on one Apache server. The virtual hosts can be IP-based or - name-based. IP-based - virtual hosting uses a different IP address - for each website. Name-based virtual hosting uses the clients - HTTP/1.1 headers to figure out the hostname, which allows the - websites to share the same IP - address. + name-based. + IP-based virtual hosting uses a different + IP address for each website. Name-based + virtual hosting uses the clients HTTP/1.1 headers to figure + out the hostname, which allows the websites to share the same + IP address. To setup Apache to use name-based virtual hosting, add a VirtualHost block for each website. For example, for the webserver named www.domain.tld with - a virtual domain of www.domain.tld with a + virtual domain of www.someotherdomain.tld, add the following entries to httpd.conf: @@ -4456,9 +4454,8 @@ DocumentRoot /www/someotherdomain.tld Apache modules - Apache uses - modules to augment the functionality provided by the basic - server. Refer to Apache uses modules to augment + the functionality provided by the basic server. Refer to http://httpd.apache.org/docs/current/mod/ for a complete listing of and the configuration details for the available modules. @@ -4467,11 +4464,11 @@ DocumentRoot /www/someotherdomain.tld www/apache24 port. Type make config within /usr/ports/www/apache24 to see which - modules are available and which are enabled by - default. If the module is not compiled with the port, the - &os; Ports Collection provides an easy way to install - many modules. This section describes three of the most - commonly used modules. + modules are available and which are enabled by default. If + the module is not compiled with the port, the &os; Ports + Collection provides an easy way to install many modules. This + section describes three of the most commonly used + modules. <filename>mod_ssl</filename> @@ -4484,9 +4481,10 @@ DocumentRoot /www/someotherdomain.tld cryptography The mod_ssl module uses the - OpenSSL library to provide strong cryptography via the - Secure Sockets Layer (SSLv3) and Transport Layer - Security (TLSv1) protocols. This module provides + OpenSSL library to provide strong + cryptography via the Secure Sockets Layer + (SSLv3) and Transport Layer Security + (TLSv1) protocols. This module provides everything necessary to request a signed certificate from a trusted certificate signing authority to run a secure web server on &os;. @@ -4506,16 +4504,16 @@ DocumentRoot /www/someotherdomain.tld The - mod_perl module makes it possible - to write Apache modules - in Perl. In addition, the persistent interpreter embedded - in the server avoids the overhead of starting an external - interpreter and the penalty of Perl start-up time. + mod_perl module makes it possible to + write Apache modules in + Perl. In addition, the + persistent interpreter embedded in the server avoids the + overhead of starting an external interpreter and the penalty + of Perl start-up time. - The mod_perl can be installed using the - www/mod_perl2 package or - port. Documentation for using this module can be found at - The mod_perl can be installed using + the www/mod_perl2 package or port. + Documentation for using this module can be found at http://perl.apache.org/docs/2.0/index.html. @@ -4540,23 +4538,24 @@ DocumentRoot /www/someotherdomain.tld PHP: Hypertext Preprocessor - (PHP) is a - general-purpose scripting language that is especially suited - for web development. Capable of being embedded into - HTML, its syntax draws upon - C, &java;, and - Perl with the intention of allowing web developers to write - dynamically generated webpages quickly. + (PHP) is a general-purpose scripting + language that is especially suited for web development. + Capable of being embedded into HTML, its + syntax draws upon C, &java;, and + Perl with the intention of + allowing web developers to write dynamically generated + webpages quickly. To gain support for PHP5 for the - Apache web server, - install the www/mod_php5 package or - port. This will install and configure the modules required - to support dynamic PHP applications. - The installation will automatically add this line to + Apache web server, install the + www/mod_php5 package or port. This will + install and configure the modules required to support + dynamic PHP applications. The + installation will automatically add this line to /usr/local/etc/apache24/httpd.conf: LoadModule php5_module libexec/apache24/libphp5.so + - Then, perform a graceful - restart to load the PHP - module: + + Then, perform a graceful restart to load the + PHP module: &prompt.root; apachectl graceful The PHP support provided by - www/mod_php5 - is limited. Additional + www/mod_php5 is limited. Additional support can be installed using the - lang/php5-extensions - port which provides a menu driven interface to the available + lang/php5-extensions port which provides + a menu driven interface to the available PHP extensions. - Alternatively, individual extensions can be installed using - the appropriate port. For instance, to add PHP support for the + Alternatively, individual extensions can be installed + using the appropriate port. For instance, to add + PHP support for the MySQL database server, install databases/php5-mysql. @@ -4615,34 +4615,37 @@ AddModule mod_php5.c Python Django - Django is a BSD-licensed framework designed to allow - developers to write high performance, elegant web - applications quickly. It provides an object-relational - mapper so that data types are developed as Python objects. - A rich dynamic database-access API is provided for those - objects without the developer ever having to write SQL. It - also provides an extensible template system so that the - logic of the application is separated from the HTML + Django is a BSD-licensed + framework designed to allow developers to write high + performance, elegant web applications quickly. It provides + an object-relational mapper so that data types are developed + as Python objects. A rich + dynamic database-access API is provided + for those objects without the developer ever having to write + SQL. It also provides an extensible + template system so that the logic of the application is + separated from the HTML presentation. - Django depends on mod_python, - and an SQL database - engine. In &os;, the www/py-django port - automatically installs mod_python and - supports the PostgreSQL, + Django depends on mod_python, and + an SQL database engine. In &os;, the + www/py-django port automatically installs + mod_python and supports the + PostgreSQL, MySQL, or - SQLite databases, with the default - being SQLite. To change the - datbase engine, type make config within - /usr/ports/www/py-django, then install - the port. + SQLite databases, with the + default being SQLite. To change + the datbase engine, type make config + within /usr/ports/www/py-django, then + install the port. - Once Django is installed, - the application will need a project directory along - with the Apache configuration in order to + Once Django is installed, the + application will need a project directory along with the + Apache configuration in order to use the embedded Python - interpreter. This interpreter is used to - call the application for specific URLs on the site. + interpreter. This interpreter is used to call the + application for specific URLs on the + site. To configure Apache to pass requests for certain URLs to the web @@ -4670,12 +4673,12 @@ AddModule mod_php5.c Ruby on Rails - Ruby on Rails is another open source web framework that - provides a full development stack. It is optimized to make - web developers more productive and capable of writing - powerful applications quickly. On &os;, tt can be installed - using the www/rubygem-rails package or - port. + Ruby on Rails is another open + source web framework that provides a full development stack. + It is optimized to make web developers more productive and + capable of writing powerful applications quickly. On &os;, + tt can be installed using the + www/rubygem-rails package or port. Refer to http://rubyonrails.org/documentation