Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 9052 invoked from network); 2 Nov 2010 13:41:18 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 2 Nov 2010 13:41:18 -0000 Received: (qmail 71181 invoked by uid 500); 2 Nov 2010 13:41:50 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 70957 invoked by uid 500); 2 Nov 2010 13:41:47 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 70950 invoked by uid 99); 2 Nov 2010 13:41:46 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 02 Nov 2010 13:41:46 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 02 Nov 2010 13:41:43 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id E173E23888FD; Tue, 2 Nov 2010 13:40:28 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1030041 - in /httpd/httpd/trunk/docs/manual/howto: htaccess.html.en htaccess.xml Date: Tue, 02 Nov 2010 13:40:28 -0000 To: cvs@httpd.apache.org From: gryzor@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20101102134028.E173E23888FD@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: gryzor Date: Tue Nov 2 13:40:27 2010 New Revision: 1030041 URL: http://svn.apache.org/viewvc?rev=1030041&view=rev Log: Porting previous commit on 2.2 doc, with a not about why .htaccess is bad when you have access to main server config. Modified: httpd/httpd/trunk/docs/manual/howto/htaccess.html.en httpd/httpd/trunk/docs/manual/howto/htaccess.xml Modified: httpd/httpd/trunk/docs/manual/howto/htaccess.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/howto/htaccess.html.en?rev=1030041&r1=1030040&r2=1030041&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/howto/htaccess.html.en (original) +++ httpd/httpd/trunk/docs/manual/howto/htaccess.html.en Tue Nov 2 13:40:27 2010 @@ -40,6 +40,9 @@ changes on a per-directory basis.

top

.htaccess files

+
You should avoid using .htaccess files completely if you have access to + httpd main server config file. Using .htaccess files slows down your Apache server. + Any directive that you can include in a .htaccess file is better set in a Directory block, as it will have the same effect with better performance.
top
@@ -103,7 +106,7 @@ changes on a per-directory basis.

In general, you should only use .htaccess files when you don't have access to the main server configuration file. There is, for example, a common misconception that user authentication should - always be done in .htaccess files, and, in more recent years, + always be done in .htaccess files, and, in more recent years, another miscomception that mod_rewrite directives must go in .htaccess files. This is simply not the case. You can put user authentication configurations in the main server @@ -124,7 +127,7 @@ changes on a per-directory basis.

However, in general, use of .htaccess files should be avoided when possible. Any configuration that you would consider putting in a .htaccess file, can just as effectively be - made in a <Directory> section in your main server + made in a <Directory> section in your main server configuration file.

There are two main reasons to avoid the use of @@ -397,7 +400,7 @@ Options +IncludesNoExec -ExecCGI
a level sufficient for the directive you've used. Consult the documentation for that particular directive to determine which is the case.

- +

Alternately, it may tell you that you had a syntax error in your usage of the directive itself.

Modified: httpd/httpd/trunk/docs/manual/howto/htaccess.xml URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/howto/htaccess.xml?rev=1030041&r1=1030040&r2=1030041&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/howto/htaccess.xml (original) +++ httpd/httpd/trunk/docs/manual/howto/htaccess.xml Tue Nov 2 13:40:27 2010 @@ -31,6 +31,9 @@ changes on a per-directory basis.

@@ -325,7 +328,7 @@ Options +IncludesNoExec -ExecCGI
in a Directory section, in your main server configuration file, is the preferred way to implement this, and .htaccess files should be used only - if you don't have access to the main server configuration file. See above for a discussion of when you should and should not use .htaccess files.

@@ -430,7 +433,7 @@ Options +IncludesNoExec -ExecCGI
a level sufficient for the directive you've used. Consult the documentation for that particular directive to determine which is the case.

- +

Alternately, it may tell you that you had a syntax error in your usage of the directive itself.