From owner-svn-doc-all@FreeBSD.ORG Wed Apr 16 17:32:07 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 4957B86A; Wed, 16 Apr 2014 17:32:07 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 2A5E41A81; Wed, 16 Apr 2014 17:32:07 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3GHW7Nf037833; Wed, 16 Apr 2014 17:32:07 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3GHW7G5037832; Wed, 16 Apr 2014 17:32:07 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404161732.s3GHW7G5037832@svn.freebsd.org> From: Dru Lavigne Date: Wed, 16 Apr 2014 17:32:07 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44582 - head/en_US.ISO8859-1/books/handbook/network-servers X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Apr 2014 17:32:07 -0000 Author: dru Date: Wed Apr 16 17:32:06 2014 New Revision: 44582 URL: http://svnweb.freebsd.org/changeset/doc/44582 Log: Finish editorial pass through Apache chapter. Update mod_php to reflect the new port. Comment out some of the mod_php config until it can be confirmed as required--the new port does not add these lines and I suspect they were only needed in Apache 1.x. Add some references. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Wed Apr 16 17:21:04 2014 (r44581) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Wed Apr 16 17:32:06 2014 (r44582) @@ -4498,21 +4498,21 @@ DocumentRoot /www/someother - <filename>mod_perl2</filename> + <filename>mod_perl</filename> - mod_perl2 + mod_perl Perl The - mod_perl2 module makes it possible + 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_perl2 can be installed using the + The mod_perl can be installed using the www/mod_perl2 package or port. Documentation for using this module can be found at /www/someother - <application>mod_php</application> + <filename>mod_php</filename> @@ -4539,57 +4539,27 @@ DocumentRoot /www/someother PHP - PHP, also known as - PHP: Hypertext Preprocessor is a + 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 + 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, begin by - installing the lang/php5 - port. - - If the lang/php5 - port is being installed for the first time, available - OPTIONS will be displayed automatically. - If a menu is not displayed, i.e., because the - lang/php5 port has been installed some - time in the past, it is always possible to bring the - options dialog up again by running: - - &prompt.root; make config - - in the port directory. - - In the options dialog, check the - APACHE option to build - mod_php5 as a loadable module for - the Apache web server. - - - A lot of sites are still using PHP4 - for various reasons (i.e., compatibility issues or already - deployed web applications). If the - mod_php4 is needed instead of - mod_php5, then please use the - lang/php4 port. The - lang/php4 port - supports many of the configuration and build-time options - of the lang/php5 - port. - - - This will install and configure the modules required + Apache web server, + install the www/mod_php5 package or + port. This will install and configure the modules required to support dynamic PHP applications. - Check to ensure the following sections have been added to - /usr/local/etc/apache22/httpd.conf: + The installation will automatically add this line to + /usr/local/etc/apache24/httpd.conf: - LoadModule php5_module libexec/apache/libphp5.so - - AddModule mod_php5.c + LoadModule php5_module libexec/apache24/libphp5.so + + Then, perform a graceful + restart to load the PHP module: &prompt.root; apachectl graceful - For future upgrades of PHP, the - make config command will not be required; - the selected OPTIONS are saved - automatically by the &os; Ports framework. - - The PHP support in &os; is extremely - modular so the base install is very limited. It is very - easy to add support using the + The PHP support provided by + www/mod_php5 + is limited. Additional + support can be installed using the lang/php5-extensions - port. This port provides a menu driven interface to - PHP extension installation. - Alternatively, individual extensions can be installed using - the appropriate port. - - For instance, to add support for the - MySQL database server to - PHP5, simply install the port + 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 + MySQL database server, install databases/php5-mysql. After installing an extension, the @@ -4640,15 +4603,11 @@ DocumentRoot /www/someother dynamic - In the last decade, more businesses have turned to the - Internet in order to enhance their revenue and increase - exposure. This has also increased the need for interactive - web content. While some companies, such as µsoft;, - have introduced solutions into their proprietary products, - the open source community answered the call. Modern options - for dynamic web content include Django, Ruby on Rails, - mod_perl2, and - mod_php. + In addition to mod_perl and + mod_php, other languages are + available for creating dynamic web content. These include + Django and + Ruby on Rails. Django @@ -4656,54 +4615,54 @@ DocumentRoot /www/someother Python Django - Django is a BSD licensed framework designed to allow + 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, - and a rich dynamic database-access API is provided for those - objects without the developer ever having to write SQL. It + 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 + logic of the application is separated from the HTML presentation. - Django depends on mod_python, - Apache, and an SQL database - engine. The &os; Port will install all of - these pre-requisites with the appropriate - flags. - - - Installing Django with - <application>Apache2</application>, - <application>mod_python3</application>, and - <application>PostgreSQL</application> - - &prompt.root; cd /usr/ports/www/py-django; make all install clean -DWITH_MOD_PYTHON3 -DWITH_POSTGRESQL - - - Once Django and these pre-requisites are installed, - the application will need a Django project directory along - with the Apache configuration to use the embedded Python - interpreter. This will be the interpreter to - call the application for specific URLs on the site. - - - Apache Configuration for Django/mod_python - - A line must be added to the apache - httpd.conf file to configure Apache - to pass requests for certain URLs to the web - application: + 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. + + 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. + + To configure Apache to pass + requests for certain URLs to the web + application, add the following to + httpd.conf, specifying the full path to + the project directory: <Location "/"> SetHandler python-program - PythonPath "['/dir/to/the/django/packages/'] + sys.path" + PythonPath "['/dir/to/the/django/packages/'] + sys.path" PythonHandler django.core.handlers.modpython SetEnv DJANGO_SETTINGS_MODULE mysite.settings PythonAutoReload On PythonDebug On </Location> - + + Refer to https://docs.djangoproject.com/en/1.6/ + for more information on how to use + Django. @@ -4711,13 +4670,17 @@ DocumentRoot /www/someother Ruby on Rails - Ruby on Rails is another open source web framework that - provides a full development stack and is optimized to make + 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. It can be installed easily - from the ports system. + powerful applications quickly. On &os;, tt can be installed + using the www/rubygem-rails package or + port. - &prompt.root; cd /usr/ports/www/rubygem-rails; make all install clean + Refer to http://rubyonrails.org/documentation + for more information on how to use Ruby on + Rails.