Installation

Requirements

• PHP 7+
• Your favourite SQL database
• Webserver (Nginx recommended)

Installation

Download or clone the repository.

Copy the module located in the compiled folder to your PHP modules folder on your server.

https://github.com/kytschi/dumb-dog/blob/main/compiled

Now create an ini to load the module in your PHP modules ini folder.

; configuration for php to enable dumb dog
extension=dumbdog.so

You can also just create the ini and point the extension to the folder with the dumbdog.so.

And don't forget to restart your webserver.

If you have issues with the module you may need to compile it yourself.

See https://docs.zephir-lang.com/0.12/en/installation for more information on installing Zephir-lang and compiling.

Create yourself a database and run the SQL located in the setup folder.

https://github.com/kytschi/dumb-dog/blob/main/setup/database.sql

Once the database is setup and the SQL installed, go to the .dumbdog-example.json in the root folder and copy it to a file called .dumbdog.json. This is where you can configure Dumb Dog. Now set the database connection details to that of your newly created database.

"database":
{
    "type": "mysql",
    "host": "localhost",
    "port": "3306",
    "db": "dumb_dog",
    "username": "dumb_dog",
    "password": "password"
}

Generate a random key for the encryption part of Dumb Dog, can use a command like the following and save that to the encryption variable in the dumbdog.json file.

openssl rand -base64 32

Next point your webserver to the public folder of Dumb Dog where the index.php is located.

Make sure that the public/website/files folder has permission to write to by your webserver's user. This folder is used to store any files you upload via Dumb Dog.

NOTE

If your using a template engine please make sure that the cache folder has write permissions by the webserver user.

That's it, now you can access Dumb Dog via whatever url you've setup for the project by adding /dumb-dog to the url.

Default login is username dumbdog and password is woofwoof.

DONT FORGET TO CREATE YOUR OWN USER AND DELETE THE DEFAULT ONE OR CHANGE ITS PASSWORD!