|
Contents
Base Requirements
In order to setup phparchive the following prerequisits are necessary.
- A Web Server enabled to run PHP like Apache Web Server (http://www.apache.org)
- PHP version 4.xx (mod_php) Apache module (http://www.php.net)
- MySQL database server (http://www.mysql.com)
NOTE: From first phparchive version, I wrote a SQL abstraction
class, this means that phparchive supports MySQL and ODBC. The official
test server is MySQL which is used to develop phparchive. Any feedback
about others SQL Servers and how it works will be very appreciated and
useful.
The above doesn't mean it will not work with other configurations,
OS's, DB's, etc, but we only provide INSTALL instructions for the above
configuration. Infact phparchive is projected to work under Windows (all),
FreeBSD, OS/2, MacOS, etc.
Installing the Package (valid only for MySQL)
Untar the package into the directory you want to use
on you web server, if you're unsure where that is, ask you system administrator.
(Windows users can use WinZip or WinRAR to uncompress .tar.gz files)
tar -zxvf phparchive.tar.gz
Now go to the directory where you uncompressed all files
and edit the file "config.inc.php". Change all the fields until you are
happy with the changes and they fits the need of your web site. Give special
attention to the database configuration section. When you have finished
to edit config.inc.php file, point your web browser to your web site at
install.php page.
If all goes well, the step by step system will detect
this first run and automaticaly will create the database, all tables and
all default data for this new database. No more action required by your
side.
If you will use ODBC or you want to choose another Database do this
manually and you need to use the Alternate Install Method, explained bellow.
Alternate Install Method
If the above method fails for some weird reason, you
can do the database setup manually. To do this change to the /db/ directory
and there is a file called "phparchive.dmp" this file contains the commands
to build the database structure, tables and the default data.
- Create a database called phparchivedb:
mysqladmin create phparchivedb
- Now fill the databases with the tables in
phparchive.dmp file:
mysql phparchivedb < phparchive.dmp
- That's it!... now you need to edit the file
"config.inc.php" to set the database options. Please read carefully the
instruction on that file! After that, point your browser to:
http://yourdomain.com/index.php
We use MySQL as the example and phparchive.dmp file is
in MySQL format because phparchive was made using this database server. You
can find many programs out there to convert the database schema from MySQL
to whatever else you want. But this is a task for you.
First Run
Your default Super User name is: admin
Your default Super User password is: admin
NOTE: If you want to edit config.inc.php file from web
browser remember to chmod 666 the file config.inc.php or your changes will
not be saved! If can't execute chmod just edit the file by hand and re-upload
it to your server.
SECURITY TIP: It's a good choice to put your config.inc.php
file outside the Web Server path, then you can create a new config.inc.php
with the line: <?php include("../config.inc.php"); ?>
Testing the Installation
Go to your homepage, for example:
http://yourdonaim.com/index.php
*** For security reasons please remember to change
the Super User password
*** IMMEDIATELY!!!
*** Remember to "Logout" from admin after you use it, from this area
you can delete or add content on your site, never leave your computer without
logggin out from the admin account. If something bad happens don't come
crying to me.
I recommend the use of phpMyAdmin. It's a good administration
system for MySQL databases. To download it just go to http://www.phpmyadmin.net/
I also recommend to set a password for your MySQL access.
This is important as some data in the nuke database is not encrypted,
so for security reasons you need to set a password, not only that, it's
a good practice!
Final Notes
That's it! You're done with phparchive. Just navigate
around, play with it, abuse it and if you like phparchive, use it. Spend
some time getting used to the administration interface. To change your
site's logo, go to the themes directory and make a custom logo for each
individual theme. Just navigate around all themes and change the graphics
you want. If you plan to give something in change for phparchive
as a contribution, please read the file SUPPORT included in this package
to have some ideas.
*** Special Thanks to all the people who help sending
bugs reports, fixes, new add-ons, requests for new features, etc... I really
appreciate you all! ***
Enjoy!
|
