WACSip
Web-based Adult Content Server
A PHP interface for WACS
Package Installation
If you are using Fedora 14 or 15, wacs-php is available as an RPM
package; for Ubuntu 10.04, 10.10 and 11.04 users there is a DEB package.
If you simply install this, it should pull in the other packages
it requires for you. Once completed, the samples and documentation will
be found in /usr/share/wacs/samples/php. Additionally there is
a second package called wacs-php-skins-simple which is a small sample
web site implemented using the Wacs-PHP interface API. This can be used
as the basis of building your own web site, or just as an alternative
simpler interface to the WACS system.
Manual Installation
There are two steps to installing wacs-php. The first is to make sure
that the PEAR DB perl module is present along with the appropriate driver
for the database you're using. If you're using MySQL on one of the Linux
distributions supported by Wacs, the wacs easyinstall script should have
already taken care of this for you. If not, the package names you need
are:
| Pre-requisite | Description | Fedora Installation |
Ubuntu Installation |
|---|
| php-devel | PHP module build tools |
yum install php-devel | ? |
|---|
| php-pear | The basic module set and installer |
yum install php-pear | apt-get install php-pear |
|---|
| php-pear-DB | The database access modules |
yum install php-pear-DB | ? |
|---|
| oci8 (Oracle only) | Driver for Oracle 8,9,10,11 |
pecl install oci8 | ? |
|---|
| Remember to add extension=oci8.so to /etc/php.ini,
the pecl installer puts it in the wrong place on Linux/x86_64 machines.
|
The second step is to install the
wacs.php, wacsui.php and XMLSimple.php modules into
the appropriate pear directory (usually /usr/share/pear).
Once you've determined the correct location for the pear modules, the
installation of the Wacs-PHP modules can be done with:
# cp -p unpack_location/modules/wacs.php /usr/share/pear
# cp -p unpack_location/modules/wacsui.php /usr/share/pear
# cp -p unpack_location/modules/XMLSimple.php /usr/share/pear
#
Configuration
You will need to make sure that the "database" attribute "phpdbconnect"
is correctly defined in your configuration file. If you're using Wacs
version 0.6.2 or later, this should already be defined by default if you
are using MySQL as the backend database. If you're using the 0.6.1 release
or Oracle 10i as the backend database, you will need to add it manually to
your configuration file. For the default names with MySQL, it should read:
mysql://wacs:wacs@mysqlhost/wacs
where mysqlhost is the hostname of the machine on which you are running
MySQL.
For Oracle 10i or later, you will need a phpdbconnect string something
like:
oci8://wacs:wacs@orasrv1/orasid
where orasrv1 is the hostname of the machine on which you are running
Oracle 10i and orasid is the SID (instance name) of the oracle database
you are using. Note that oci8 refers to the SQL*Net protocol level which
has been standardised since Oracle 8 and it applies still to Oracle 9 and
Oracle 10i databases. It'll probably still apply to Oracle 11i, etc...
Back to Wacs-PHP documentation