[Sommaire] [Imprimer]

   1  <?php
   2  /**
   3  * @version $Id: INSTALL.php 5975 2006-12-11 01:26:33Z robs $
   4  * @package Joomla
   5  * @copyright Copyright (C) 2005 Open Source Matters. All rights reserved.
   6  * @license http://www.gnu.org/copyleft/gpl.html GNU/GPL, see LICENSE.php
   7  * Joomla! is free software. This version may have been modified pursuant
   8  * to the GNU General Public License, and as distributed it includes or
   9  * is derivative of works licensed under the GNU General Public License or
  10  * other free or open source software licenses.
  11  * See COPYRIGHT.php for copyright notices and details.
  12  */
  13  
  14  // no direct access
  15  defined( '_VALID_MOS' ) or die( 'Restricted access' );
  16  ?>
  17  
  18  REQUIREMENTS
  19  ------------
  20  
  21  First you must have the base environment for Joomla!.
  22  We have thoroughly tested Joomla! on: Linux, Free BSD, Mac OS X and Windows NT/2000.
  23  Linux or one of the BSD's are recommended, but anything else that can run the
  24  3 pieces of software listed below should do it.
  25  
  26  Apache    -> http://www.apache.org
  27  MySQL    -> http://www.mysql.com
  28  PHP    -> http://www.php.net
  29  
  30  
  31  SERVER CONFIGURATION
  32  --------------------
  33  
  34  You MUST ensure that PHP has been compiled with support for MySQL and Zlib
  35  in order to successfully run Joomla!.
  36  
  37  While we have reports that Joomla! works on IIS server we recommend Apache
  38  for running Joomla! on Windows.
  39  
  40  
  41  OPTIONAL COMPONENTS
  42  -------------------
  43  
  44  If you want support for SEF (Search Engine Friendly) URLs, you'll need mod_rewrite and the ability to
  45  use local .htaccess files.
  46  
  47  
  48  INSTALLATION
  49  ------------
  50  
  51  1. DOWNLOAD Joomla!
  52  
  53      You can obtain the latest Joomla! release from:
  54          http://www.joomla.org
  55  
  56      Copy the tar.gz file into a working directory e.g.
  57  
  58      $ cp JoomlaVx.x.x-Stable.tar.gz /tmp/Joomla
  59  
  60      Change to the working directory e.g.
  61  
  62      $ cd /tmp/Joomla
  63  
  64      Extract the files e.g.
  65  
  66      $ tar -zxvf JoomlaVx.x.x-Stable.tar.gz
  67  
  68      This will extract all Joomla! files and directories.  Move the contents
  69      of that directory into a directory within your web server's document
  70      root or your public HTML directory e.g.
  71  
  72      $ mv /tmp/Joomla/* /var/www/html
  73  
  74      Alternatively if you downloaded the file to your computer and unpacked
  75      it locally use a FTP program to upload all files to your server.
  76      Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and
  77      image files (GIF, JPG, PNG) in BINARY mode.
  78  
  79  
  80  2. CREATE THE Joomla! DATABASE
  81  
  82      Joomla! will currently only work with MySQL.  In the following examples,
  83      "db_user" is an example MySQL user which has the CREATE and GRANT
  84      privileges.  You will need to use the appropriate user name for your
  85      system.
  86  
  87      First, you must create a new database for your Joomla! site e.g.
  88  
  89      $ mysqladmin -u db_user -p create Joomla
  90  
  91      MySQL will prompt for the 'db_user' database password and then create
  92      the initial database files.  Next you must login and set the access
  93      database rights e.g.
  94  
  95      $ mysql -u db_user -p
  96  
  97      Again, you will be asked for the 'db_user' database password.  At the
  98      MySQL prompt, enter following command:
  99  
 100      GRANT ALL PRIVILEGES ON Joomla.*
 101          TO nobody@localhost IDENTIFIED BY 'password';
 102  
 103      where:
 104  
 105      'Joomla' is the name of your database
 106      'nobody@localhost' is the userid of your webserver MySQL account
 107      'password' is the password required to log in as the MySQL user
 108  
 109      If successful, MySQL will reply with
 110  
 111      Query OK, 0 rows affected
 112  
 113      to activate the new permissions you must enter the command
 114  
 115      flush privileges;
 116  
 117      and then enter '\q' to exit MySQL.
 118  
 119      Alternatively you can use your web control panel or phpMyAdmin to
 120      create a database for Joomla!.
 121  
 122  
 123  3. WEB INSTALLER
 124  
 125  Finally point your web browser to http://www.mysite.com where the Joomla! web
 126  based installer will guide you through the rest of the installation.
 127  
 128  
 129  4. CONFIGURE Joomla!
 130  
 131  You can now launch your browser and point it to your Joomla! site e.g.
 132  
 133      http://www.mysite.com -> Main Site
 134      http://www.mysite.com/administrator -> Admin
 135  
 136  You can log into Admin using the username 'admin' along with the
 137  password that was generated or you chose during the web based install.
 138  
 139  
 140  Joomla! ADMINISTRATION
 141  ----------------------
 142  
 143  Upon a new installation, your Joomla! website defaults to a very basic
 144  configuration with only a few active components, modules and templates
 145  (CMTs).
 146  
 147  Use Admin to install and configure additional CMTs, add users, select
 148  default language and much more.
 149  
 150  Note that additional community-contributed CMTs and languages are
 151  available via http://www.joomla.org