PHPackages                             fokuscms/blackhound - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. fokuscms/blackhound

ActiveLibrary[Framework](/categories/framework)

fokuscms/blackhound
===================

The framework behind fokus cms

016PHP

Since Oct 20Pushed 10y agoCompare

[ Source](https://github.com/fokuscms/blackhound)[ Packagist](https://packagist.org/packages/fokuscms/blackhound)[ RSS](/packages/fokuscms-blackhound/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Quickstart
==========

[](#quickstart)

**Note:** You will find the complete documentation in the projects website:

What`s this guide about?
------------------------

[](#whats-this-guide-about)

This little guide is for getting started with Blackhound. It will give you a simple step-by-step introduction in how to create a small application with the framework. You will understand the basic concepts after working through this guide. Further details are explained in the full documentation.

What is Blackhound?
-------------------

[](#what-is-blackhound)

Blackhound is a simple PHP-based framework which was created as the foundation of the **fokus² CMS**. It was made using conventions and components that are common in web development to ensure that you are able to refine this framework with us as well.

Blackhound is made using components of many other famous PHP projects as the [Symfony2](http://symfony.com/) components and using [Illuminate](https://github.com/illuminate) components (Laravel). But the framework is kept simpler than the other frameworks and was created to support developer in creating applications as fast as possible and with less boundaries.

Installing Blackhound
---------------------

[](#installing-blackhound)

The setup of this framework is very simple and has following requirements:

- A web server (something like the Apache module mod\_rewrite is recommended)
- at least PHP 5.5
- A database that is supported by Illuminate (e.g. MySQL)

At first install Composer using the [instructions of the official page](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx). We recommend to install Composer globally as you will definitely need it for other PHP-based projects as well.

Now move in your command line tool to the directory where your project should be installed and call the following command which will clone Blackhound and it's dependecies to this folder.

```
composer create-project fokuscms/blackhound  --prefer-dist

```

Replace `` with the name of your project. The new directory that was created by composer will be your project root.

> **Note for Alpha** As there isn't any stable version yet, you should prepend the flags `-s dev` to the command above. You also need git installed to be able to download the fokuscms components.

Testing your installation
-------------------------

[](#testing-your-installation)

Just visit the directory you created and you will see the following Welcome screen: [![The Welcome Screen](https://camo.githubusercontent.com/dda23525dc73078797f4113e1d1b59ae6badac25292d03f4a3ff9bbdfbe1a674/687474703a2f2f626c61636b686f756e642e64652f646f63732f696d616765732f77656c636f6d652d73637265656e2e6a7067)](https://camo.githubusercontent.com/dda23525dc73078797f4113e1d1b59ae6badac25292d03f4a3ff9bbdfbe1a674/687474703a2f2f626c61636b686f756e642e64652f646f63732f696d616765732f77656c636f6d652d73637265656e2e6a7067)

> **Notes for experienced developers:** You may comment that it is not the very best way to have the `index.php` as the entry point for the application but use a public folder where the virtual host points to. You are definitely right with this. But we still decided for this way, because Blackhound is mainly made to be the framework behind fokus² cms and this Content-Management-System is used by many users on the free hosting services that do not support changing the document root. For the future we are going to serve an alternative way, but for now this must be okay.

Hello World
-----------

[](#hello-world)

So far we have successfully installed Blackhound and now it's time to create our first application.

### Routes

[](#routes)

When you open up your project in your IDE you will see the following projects structure:

```

    -- content/
        -- lang/
            -- de-DE/
    -- system/
        -- app/
            -- Http/
                -- Controllers/
            -- views/
        -- config/
    -- vendor/
    index.php
    composer.json
    composer.lock

```

There are more files and some more directories than listed here but this shows the basic structure of the project. The entry point is `index.php`. Every request that is sent will be processed by this file. At first it looks up the requested route with the ones you have registered.

You can register your routes in `system/app/Http/routes.php`. You will find a sample route in this file that matches to the welcome screen:

```
$router->get('/', 'HomeController::index', array('name' => 'home'));

```

This route matches to the entry-point of your project `/` and starts the `index()` action of the `HomeController` which you can find in `/system/app/Http/Controllers/`.

Let's create our own route for our "Hello world"-page:

```
$router->get('/hello-world', 'HomeController::hello', array('name' => 'hello'));

```

Now we have created a route to `/hello-world` that should call `hello()` of the `HomeController`

### Controller

[](#controller)

So now let's switch to the Controller. You will already find `index()`. And you will see that it does nothing more than returning the results of `$this->render();`.

This function gets the view file in the first parameter and an array of data in the second parameter. As a result it will create a Response using the defined view file and replacing all its variables with the one defined in the array.

So let's create our action. In our definition of the route we called the function "hello", so we have to name it here as `hello()` as well. And we are going to render a view called "hello".

In the sample function you see `"index:index.php"` as the parameter for the view-file. The colon is simply the seperator between the folders. So in this case you can say that you can find the view-file in the directory `index/` and it is named as `index.php`. Starting point for views is always `/system/app/views`. If you now look this file up, you will find the view-file.

### Views

[](#views)

So in our controller we have now created the following function:

```
public function hello(){
    return $this->render("hello.php", []);
}

```

So now it`s time to create the view-file. Following the explanation above the view-file should be created in `/system/app/views/hello.php`. And now it's easy. Just create a simple HTML-File as you know, for example the following one:

```

    Welcome to Blackhound!

    Hello world

```

If you now open this route in your browser exactly this screen will be displayed. Easy, huh? That was a quickstart. Of course you can do a little more with Blackhound (although we are at the beginning and do not have implemented that much so far). Check out detailed component pages to find out more.

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/807099f1005fca40373fe17c44b318b5574b58f851c9eb747aa2112283cc9f81?d=identicon)[rathesDot](/maintainers/rathesDot)

### Embed Badge

![Health badge](/badges/fokuscms-blackhound/health.svg)

```
[![Health](https://phpackages.com/badges/fokuscms-blackhound/health.svg)](https://phpackages.com/packages/fokuscms-blackhound)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)