Support This Project If you like this application and you want that continue the development, please make a donation.

PHPfileNavigator version >= 1.5.8

Copyright (C) 2005 Lito : http://phpfilenavigator.litoweb.net

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

If you like colaborate in this proyect sending translations or bug errors, please contact with me by email (phpfilenavigator@litoweb.net) or in the web phorum (http://phpfilenavigator.litoweb.net/phpBB2/)

Thaaaaaaaaaaaanks, Lito.

I notice that my english is very very bad.

REQUERIMENTS

This application was tested in systems Windows XP and several Linux distributions with PHP versions from 4.0.6 since 4.3.8, with which I recommend that one settles being based on these conditions. Also it's tested (only tested ) in PHP 5.0.3.

It's tested also in Apache servers from 1.3.31 to 2.0 (and some older versions) and diverse tests in IIS servers.

It requires in addition the Mysql version 4.0.* to the correct working with the file and directories indexation.

To a total funcionality, it's recommended the installation of GD >= 2.0.1 libraries to images treatment and the ZLIB libraries to file compression.

DOWNLOAD

In the web download, exists always a file that contain the software, also can have more possible downloads with more languages and new utilities.

By defautl, since 1.5.8 version, the availables languages are spanish and english, but the package contain too the languages galician, dutch, italian, french and german into the directory data/idiomas/.

To download the PHPfileNavigator from console:

wget http://phpfilenavigator.litoweb.net/PHPfileNavigator.zip

INSTALLATION

Before the installation we are due to assure that the directories "data/conf/", "data/logs/", "data/info/" and "tmp/" must have writing permissions to the web server user (usually apache), also in update mode, the file "data/conf/basicas.inc.php" must have writing permissions.

By default the software have availables the Spanish and English languages, but you can install in Galician, Dutch, Italian, French or German unziping the zip file that you need in the directory "data/idiomas/".

This software allow several installation and upgrade modes.

To the first installation, show must cover this data:

Email: email to send the hackers os logins alerts
GD2: If have GD2 library
ZLIB: If have ZLIB library

Data Base

Host: Data base server name (default localhost)
Name: Data base name (must exists)
Usuer: User with data base access
Password: User Password
Table prefix: The tables can will be created with a prefix in order to avoid overwrite the yet existing.

Administration

Nombre: Nick of the administrator
User: User to load in the PHPfileNavigator
Password: Admin Password
Repeat Password: Repeat the password

Initial Root

Name: Name of diretory that exists as initial root, can be same as "Initial ROOT", "Web root", "Public Web", ...
Absloute Path: Absolute path of the initial directory. You must use "" instead of "\", and end the path with "". For example: /var/www/html/directory/
Web path: Access absolute web path. For example: /directory/
Host: Domain for this path. If we have a web server with several domains , this can allow relacionate each root whit a domain.
Configuration file: By default "default". This configuration files are in folder "data/conf/" and can allow the preferences for each root.

In case that we have an older PHPfileNavigator version, we can choose between "Upgrade from version <= 1.5.7" or "Upgrade from version > 1.5.7", and we don't have to cover any data and install the application without delete the MySQL data.

If we have a version already installed and return to choose the option "Install", then it delete the data in MySQL tables.

The installation basic data (data base access, language, GD2, ZLIB, ...) is stored in the file "data/conf/basicas.inc.php" and we can change this values if it's necessary.

To a correct upgrade, you must overwrite the older installation with new files , saving a backup of files paths.php and "data/conf/default.inc.php", the first file contain the application paths, and the second the initial preferences. These preferences can be different in new and older version, so the recommendable it's review the files to compare the changes and overwrite the older file with the new.

Once time executed the installer, you must delete the folder "instalar/" or come back the install screen.

STRUCTURE

PHPfileNavigator is made up of the following structure:

PHPfileNavigator
|-- data
|   |-- accions
|   |-- conf
|   |-- idiomas
|   |   |-- eng
|   |   |-- es
|   |-- include
|   |-- info
|   |-- logs
|   `-- plantillas
|-- imx
|   `-- ico
|-- instalar
|-- js
|-- tmp
`-- xestion
    |-- indexador
    |-- raices
    `-- usuarios

In the folder "data/idiomas/" there are all availables languages, some ones in zip format. To use this languages, only have to unziped and change the language configuration in "data/conf/basicas.inc.php".

In the folder "data/conf/" can find the configuration files. By default exists two, "basicas.inc.php" created after installation and "default.inc.php" that contain the root configuration. Several roots can be related with only a configuration file, or you can create so many configurations as you need.

In the folder "data/logs/" is stored the MySQL errors in the file "sql.php". This file save each error with data/time, file and query.

The folder "instalar/" contain the installer and you must delete after installation.

The folder "xestion/" contain the users and roots administration, and the file and folder indexed.

FUNCTIONALITY

Basically the PHPfileNavigator allows the file and directories navigation and administration in a remote server, but in addition it allows the accomplishment of certain extra actions:

  • Additional data files

  • Allow the additional data files creation by each file or directory. This option it's actived by default, but you can change this value in the configuration file "data/conf/default.inc.php" changing the value in key "estado" in "inc" position to false.

  • Secure

  • Strong access control to users and much security tests. The sessions are encripted and the datos stored in them not show important information if are decripted (very very difficult)

  • Indexing

  • Allow file indexing by name or data saved in additional data files.

  • Control web access

  • If folder/s which we managed has access through Web, .htpasswd will allow us to control the access through the files in which it will store an user and password.

    To create this protection, only have to click in a folder icon in the file list. Then choose the "Protect" option and write the user and pass that can access by web. To delete this protection, only send the from with blank fields.

  • Tree view

  • PHPfileNavigator allow view all the root content in tree format. So we can choose between only directories or all content option, and we can view the total root size, and count all the directories and files.

  • Size limit

  • One useful tool to the shared roots, is the size limit, those we will allowed put a folder limit that can't be surpassed.

    To do this, we will should to acess how admin in the root administration and put a limit size in "Size limit" field.

    Then the PHPfileNavigator obtain the actual folder size and will create in "data/info/" a folder with root id and two files onto, one with root limit and other with actual size, that will update when copy, delete, upload, ...

  • Powerful administration

  • PHPfileNavigator allow one complete and easy root and folder administration.

    The admin user will have posibility to create users and roots, and related.

    One user or root can be deleted or inactive if you need.

  • Image management

  • One powerfull option in this software is the image management and manipulation that allow create custom thumbnails of each big one.

    So we can view this thumbnails in the file list and the tree view.

  • File download

  • PHPfileNavigator allow the file or web download from remote site. We can do those if choose "Upload URL" and the file will be downloaded to our server.

  • File edition

  • In addition of a tipical file admin actions (copy, move, delete,...) we can edit the text files. The type of editables files can be configured in the file "data/conf/degault.inc.php", in an array of extensions. So we can only view the contain data.

    These are single some of the multiple functions which it has this application distributed under license GPL.

    RECOMMENDATIONS

    WARNING: The use by several roots is not nothing recommendable on same path or subpath since it can cause problems with the indexed and the limitor of size.

    If I create a root "var/www/html/" and other "var/www/html/directory/", and limit some one (or two) in file size, when I'm working in some one and add files, or delete or move or copy,... the other root isn't going away to find out and the file search will give back incorrect information and the actual folder size is incorrect.

    DONATIONS

    If you think that this tool can you be useful and you like that I continue in the development (although my English is terrible), please do a donation in the PAYPAL button.

    To all peple that colaborate in the PHPfileNavigator, THANKS.