Manual:Short URL/Apache/it

Queste istruzioni sono d'aiuto per l'impostazione di indirizzi brevi su Apache. Il server web LiteSpeed è compatibile con Apache e può essere configurato relativamente allo stesso modo. Per informazioni su cosa sono gli indirizzi brevi (Short URLs), o per istruzioni sulla configurazione per altri server, vedi. Se non sai quale server stai usando, ad es. perché utilizzi qualche tipo di servizio hosting, è probabile che tu stia usando Apache.

Setup
Prima di iniziare, devi decidere il nome del percorso dei tuoi indirizzi brevi.

In questo manuale raccomandiamo, e diamo per sottinteso, ciò che segue. Ricorda di usare sempre i tuoi specifici percorsi se sono diversi.


 * La directory MediaWiki si trova a:
 * Il formato di indirizzo breve desiderato è:

Le seguenti istruzioni sono incluse in un wizard automatizzato (richiede MediaWiki 1.17 o successivo):


 * shorturls.redwerks.org

Se ti serve soltanto configurare velocemente il tuo wiki, o se trovi la guida poco chiara, potresti voler provare quel servizio, prima. Se lo fai, nota che dovrai creare o modificare un file .htaccess. Se ne crei uno nuovo di zecca, leggi più avanti in questa pagina dove mettere il file .htaccess, e nota che questo file probabilmente sarà in una directory diversa rispetto all'altro file che va editato (LocalSettings.php), che è nella directory di installazione (/w, se hai seguito le istruzioni di MediaWiki). Tieni inoltre conto del fatto che questo wizard non lavora su wiki privati o chiusi da firewall. In questo caso, potresti provare a rendere temporaneamente pubblico il tuo wiki impostando  su. Dopo ricorda di riportarlo a  una volta terminato.

Altrimenti segui le istruzioni qui sotto.

Trova il file giusto
Il modo raccomandato di impostare indirizzi brevi in Apache è mediante modifica dei file di configurazione di Apache. Ciò richiede che tu abbia accesso alla configurazione del server. Se ti trovi in un hosting condiviso, assai probabilmente non avrai questo accesso e dovrai invece usare un file. Usare i file  è meno efficiente e non ti offre lo stesso controllo in caso di setup complessi con domini multipli; ma i file   sono comunque abbastanza potenti da consentirti di impostare la maggior parte delle configurazioni di indirizzi brevi. Gli utenti di LiteSpeed dovrebbero usare il metodo.

Usa le istruzioni che trovi in una delle due seguenti sezioni, a seconda del fatto che tu abbia un accesso root o che debba usare invece i file.

Trova i file di configurazione di Apache (accesso root)
The correct configuration file to edit for root configurations may be in one of a number of places.

The correct config file to edit is the one in  where the configuration for your wiki has been setup. Most linux distributions setup Apache with set of  and   folders setup.

If you haven't set one up and are using the default  for your wiki setup then you can edit.

Don't forget to enable overrides by  in. It is disabled by default in Ubuntu 12.04 and Ubuntu 12.10.

If your distribution does not have those directories, then you should edit the Apache configuration file directly. This file should be at. Note that it used to be named, if you have a   and no   then   is the one you want to edit.

If your Apache config isn't in any of these spots you should consult the documentation for whatever system you used to install Apache, and find the location of the Apache configuration file.

If you're on a shared host without access to Apache config files you'll have to use a .htaccess file instead.

In an Apache config file you will likely have a VirtualHost block containing your wiki. If you do have one then that is the location where your rewrite rules will go. RewriteRule config does not inherit so don't put these config options in the global config if you are using a VirtualHost.

After you've setup the config as above inside Apache you're going to need to restart Apache to make it apply the new config.


 * If you are using Plesk or cPanel it should have a method of restarting the server.
 * From the command line the command is usually something like,  ,   or as on the latest Fedora releases  . These commands need to be run as root, usually by prefixing them with.

Dove vanno messi i file .htaccess
If you're using a  file you'll need to edit or create the file. Find the path that contains both your script path and your virtual path. Usually this means the top directory of your site, but let's look at a few examples:

Note that if you want to make a redirect from the main domain to your wiki's Main Page (e.g. http://example.org/ http://example.org/wiki/Main_Page ). Then you always have to set up the .htaccess file in the top level, even if the other directories are nested deeper.

Impostare le regole di riscrittura (rewrite rules)
It's easier to understand the rest of this section after a glimpse at the Apache syntax, but this synopsis is not a substitute for the full Apache documentation:

The  directive defines a condition that must be true before a RewriteRule that follows it may be applied. One or more RewriteCond directives may precede a RewriteRule directive, and all the RewriteCond directives that precede a RewriteRule must be true before that rule may be applied to a URI. In the examples that follow,  takes the form of a reference to server variables, e.g.. Although many  exist, the examples that follow use   (true when TestString is a regular file) and   (true when TestString is a directory), and they are preceded by a negation symbol,.

The  directive may be invoked in both the   file and in any   file, but when the rewrite rule appears in .htaccess files, the implicit per-directory context affects the rule's   because rules are relative to the current directory. In  files, Patterns are not relative to the complete, original URI. For  files, Patterns should never start with a forward slash, , because the URI sub-string will never begin with a. The examples that follow use the  flag whose meaning is Stop the rewriting process immediately, and don't apply any more rules.

The first rule you'll need inside of your config is one to enable the rewrite engine:

Now we need a rule to make your article path a virtual path pointing to index.php. Be sure to replace  and   with the paths you chose in the beginning (if different).

If you are using a root url instead of a normal short url you will need to use the following instead (to ensure that existing files and directories are not seen as article, e.g. " " " " etc.):

Sometimes, the above example doesn't work. The following (you can't set this in a, you need root access for this!) might work instead:

Optionally, you can include a rule to show the Main Page on the path itself, to simplify navigation when people visit urls without a page title specified:

The end result should look something like this:

or, if you used the way with the "Alias" statement:

LocalSettings.php
We need to make the following configurations in :

If you get an "Internal error" page saying "Redirect loop detected!" after you finish configuration you may be using something other than mod_php. If so you need to explicitly turn on short urls using the following line in your LocalSettings.php:

If there is still an "internal error" check the log files of your server. Maybe you have to turn on  module.

Istruzioni semplificate
Ciò che segue è una sintesi di cosa fare se non stai facendo nulla di diverso da quanto MediaWiki raccomanda. Se vuoi fare qualcosa di diverso, dovrai leggere tutti i dettagli sopra.


 * https://example.com/wiki/Main_Page (url location (posizione dell'indirizzo))
 * /home/me/public_html/mediawiki/w/index.html (index.html location)
 * /home/me/public_html/mediawiki/.htaccess (.htaccess location)

Nota che il file .htaccess NON si trova nella directory "w", ma in quella sopra di questa.