install.txt

php+mysql做的调查问卷管理系统php+mysql做的调查问卷管理系统

phpQuestionnaire version 2.2 Installation Instructions
------------------------------------------------------

It is recommended that you view the documentation for phpQ, which can be found
in the docs/ directory of this package.  The file is index.html.  You may also
view the documentation at: http://www.chumpsoft.com/index.php?page=phpqdocs

To perform an automatic installation of this package, please follow these steps:

1. When unpacking the files, they will all be placed in appropriate locations 
   within a base directory of 'phpQ/'. Move or Upload this directory onto your
   web server into a location accessible from your browser.

   NOTE ON UPGRADING: If you are upgrading from a previous version of
   phpQuestionnaire, we recommend backing up your current version in case you
   have any problems.  Be careful if you have made changes to your
   current version. For instance, do not erase any templates you may have
   created or modified and if you have changed any other files in phpQ, your
   modifications may be lost if you have not properly backed them up to another
   directory.  If you encounter any problems with the automatic upgrader (it
   can update any prior version) please let us know.

   Furthermore, if you are upgrading from a version PRIOR to 2.0, there have
   been numerous changes in including some that can affect the way a survey
   appears to the user.  We strongly recommend setting up v2.2 in a parallel
   directory, upgrading the database (using the Upgrade option in the
   install.php file) and then testing your existing surveys.  If everything
   looks good, you can then move the new version, overwriting your existing
   files (which you should backup) and the upgrade will be live. 

2. If phpQ is being hosted on a Unix based machine, you must change the 
   permissions of the file 'phpQ/inc/mysql.php' so that your web server can
   write them. To do this, you must telnet, ssh or ftp into your machine and
   issue a 'chmod' command to change the permissions. To do this, login and go
   to the phpQ/ directory of your installation. Issue the following command:

   chmod 766 inc/mysql.php

   This step is necessary, even if upgrading, so that the automatic
   installation program can write your MySQL configuration. At the end of the
   installation we will ask you to change permissions on this file again.

3. Load up the installation page by opening your web browser and going to the
   following URL:

   http://www.yourhost.com/path/to/phpQ/install.php

   You must modify this URL to include your actual domain and then the
   'path/to' must be changed to the location on your web server where you have
   placed your phpQ program.

4. You will now see a page in your web browser that contains several
   configuration variables.  You must fill in the correct MySQL configuration
   variables. If you are unsure of any of the MySQL configuration
   parameters, please consult your web hosting provider.

   MySQL Hostname
      In most cases, the MySQL Hostname should be set to 'localhost'. This is
      the most common configuration, in which both the MySQL server and the
      web server are running on the same machine.

      In some cases, your MySQL database may be running on a different machine
      from your web server. If this is so, you must enter the hostname of the
      MySQL database server here.

   MySQL Username
   MySQL Password
      Logging into a MySQL database server requires a username and password.
      This may be different from the username and password you use to access
      your web server.

   MySQL Database
      phpQuestionnaire needs to know the MySQL database to which it should add
      the configuration and survey tables. If you are able to create databases,
      you may wish to create one named 'phpQ'. In either case, please enter the
      name of your MySQL database into this box.

   If you are upgrading an existing set of phpQ tables to the newer version,
   you will also need to supply the Admin Password to prove that you are
   authorized to make this change. This password will be the same one you have
   been using to login to the phpQ admin control panel.

   Next to the upgrade button you will notice there is an option to 'Backup
   Database'. We recommend you click on this button before upgrading. Once
   clicked, you will be prompted to download a .phpQ file which contains all of
   the data from your phpQ installation. This file can then be used to restore
   your database in the very small chance something goes wrong with the upgrade.

   You may now click the 'Install' or 'Upgrade' button depending on which you
   wish to do and phpQuestionnaire will automatically perform the requested
   action, alerting you to any errors it may encounter.

5. Upon successful installation, you will see a screen summarizing the
   installation process.

6. If all of the items say success, phpQ has been correctly installed.
   Once you have checked to see that it is working, you need to change the
   permissions of your mysql.php configuration file back to normal, so that no
   one else may modify your database parameters. To do this, issue the
   following command, much like you did before:

   chmod 744 inc/mysql.php

7. It is crucial that you also remove the install.php file once you have
   successfully setup phpQ. You need to delete the file 'phpQ/install.php',
   possibly using the following command, if you are still within the phpQ/
   directory of your installation:

   rm install.php

   It is important to do this so that no one else may access this file in the
   future and create a new installation of phpQ without your authorization.

8. Click the 'Proceed to Admin' button which will take you to the login screen.
   The default password is 'password' and it should be changed quickly after
   logging in for the first time.