phparchive Ver. 0.1.86 ßeta
Home Online Documents
SourceForge Logo

Valid HTML 4.01!
Valid CSS!


Base Requirements

In order to setup phparchive the following prerequisits are necessary.

  • A Web Server enabled to run PHP like Apache Web Server (
  • PHP version 4.xx (mod_php) Apache module (
  • MySQL database server (

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 "". 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 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.

  1. Create a database called phparchivedb:
    mysqladmin create phparchivedb
  2. Now fill the databases with the tables in phparchive.dmp file:
    mysql phparchivedb < phparchive.dmp
  3. That's it!... now you need to edit the file "" to set the database options. Please read carefully the instruction on that file! After that, point your browser to:

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 file from web browser remember to chmod 666 the file 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 file outside the Web Server path, then you can create a new with the line: <?php include("../"); ?>

Testing the Installation

Go to your homepage, for example:

*** For security reasons please remember to change the Super User password
*** 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

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! ***


  Vincenzo D'Amore - © 2002/2003 Powered by PHP: Hypertext Preprocessor