Download the PHP package raphhh/puppy without Composer

On this page you can find all versions of the php package raphhh/puppy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of raphhh/puppy

Informations about the package puppy

Puppy framework

Latest Stable Version Build Status Scrutinizer Quality Score Code Coverage Total Downloads License

Puppy is a micro-framework built in PHP that helps you to create websites using Twig templates!

With Puppy, you will be able to build websites directly in Twig, without any problems of routes nor configuration. Puppy is ready-to-use: you just have to implement your html code.

Puppy uses a simple route system which you can easily extend to add your own behaviour and get more interactivity. For example, you can create a form which will be handled in back-end with Puppy.

Resources

Website

http://www.puppyframework.com/

Code

Core

Modules

Testing

About

Puppy is a skeleton that runs Puppy\Application. It uses Puppy\Config as config manager.

It includes some default modules:

Installation

Use Composer to download Puppy:

Files architecture

├── bin
|   ├── build
|   └── run
├── config
|   ├── dev.php
|   ├── global.php
|   └── tets.php
├── public
|   ├── .htaccess
|   ├── index.php
|   └── robots.txt
├── src
├── templates
|   └── public
|       └── index.html.twig
├── tests
├── vars
├── vendor
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .scrutinizer.yml
├── .travis.yml
├── composer.json
├── composer.lock
├── LICENSE
├── phpunit.xml.dist
├── puppy
└── README.md

Run the demo

Use the built-in PHP server

Use the run command in your console:

Then, you can launch Puppy in your browser at http://localhost:8080.

You can also specify you want to run the dev env (no cache).

Use any server

First, you have to know that the public http access to Puppy is the dir '/public'. It is where you will put your css or your js.

If Puppy is not located at the root of your url address, create a local config to define the base url. For example, if you will launch Puppy at 'http://localhost/puppy/public', your local config must be:

Local config is not versioned and will never go to production. For more information about config, see specific section.

See also how to set the dev env variable 'APP_ENV'.

Then, you can launch Puppy in your browser. :)

Clean the cache

To clean the cache, rebuild your project:

Create your own application

Now you want to code your site.

First, be careful with the cache of Puppy. If Puppy is cached, your modifications will not appear in the screen. See the config section to disable the cache.

Now, let's see how the static routing works.

Static routing in a nutshell

The "static routing" is a module that routes an uri to a template file. The router takes the request uri and tries to find an associated template.

Note that the template files must be in the dir "template/public/".

If the request uri points to a dir and not a file, a default file will be searched. By default: "

/index.html.twig".

If no file is found in the templates, it returns an HTTP 404 error.

Note that, because it is a module (raphhh/puppy-static-route), you can remove it. See module section for more information.

Add new pages

Consider directory '/templates/public' like a mirror of your public site access, but specially dedicated to twig templates. For each page you want in your website, you have to put a twig file in this directory. Name this file as if it was a html file, but complete it with extension '.twig'.

For example, for a home page, normally you will use a 'index.html' at the root of your public area. Here, with Puppy, you have to create a file '/templates/public/index.html.twig'. Same name, but with specific extension.

So, for example, these uri will call those twig:

  • / => templates/public/index.html.twig
  • /index.html => templates/public/index.html.twig
  • /contact.html => templates/public/contact.html.twig
  • /contact => templates/public/contact/index.html.twig
  • /contact/index.html => templates/public/contact/index.html.twig

Create common private templates

Now, imagine you want to add a second page, like a contact page for example. So, you want to display a new template for the url '/contact.html'. You just have to create this new template in the file '/templates/public/contact.html.twig'.

Once you have created your second template file, there is some duplicated code in your html (header, menu, footer, ...). No problem, here comes Twig! You can, for example, group your common base html code in a separate file that each page will extend.

As this file must not be directly accessible from an url, it must not appear in the '/templates/public' dir. You have to put it directly at the root of the '/templates' dir. So, it will never be called from any url.

Add some specific behaviours

Now, imagine you have a form in your contact page, sending an email. You can easily add a function to handle your form in php.

First, you have to add a new route to handle the posted form.

In the controller, you have to test if the form is valid for you. If the form is not valid, you can call the twig template associated with your uri, and give it an error message.

If the form is valid and you have done the job, you can redirect to avoid refresh problems.

It is easy to retrieve the message given to the template (with 'render' or 'redirect' method). You just have to use 'retriever' service.

See the DemoModule to have an example.

Config

Add all the config you want, depending on each environment. Puppy uses an easy config provider.

Your config is defined in the dir '/config'.

By default, you have two versioned config (global and dev). 'dev' config is not loaded in prod env. But to specify you are in dev env (and avoid cache), you have to set the env variable 'APP_ENV'.

Moreover, you have a third config (local) which is not versioned. You can specify stuff only for you.

For more information, see puppy-config documentation.

Routes

Add any special routes you want for particular behaviour. Puppy uses a complete route provider.

For more information, see puppy-application documentation.

Services

Add all your services you need. Puppy uses Pimple as service container.

For more information, see puppy-application documentation.

Puppy is built with pre-config services:

  • config: gives you the config of your env.
  • request: gives you the current request ($_REQUEST, ...).
  • template: handles the twig engine.
  • session: handles the session.
  • appController: gives you some nice tools to use in your controllers.
  • staticController: calls the twig template associated with the current uri.
  • frontController: calls the controller associated with the current request and display the view.
  • router: finds the controller associated with a route.
  • retriever: finds the params given to a page.

For more information about session and template, see puppy-service documentation.

Modules

A module is an external package that you can add to Puppy like a pluggin. A module can add specific services, controllers, config, and so on. See the module documentation for more information.

Adding a new module is very simple in Puppy. You just has to load the package with Composer:

That's it, it works!

Removing is also simple:

Puppy includes some default modules, like the session, the template, and the static routing. But, you can easily replace them.

HTTP response

You can manage the header of your HTTP response with the method 'after'. So, for example, you can define the http cache.

Integration and deployment

How to launch the tests?

See Travis config in .travis.yml.

How to deploy?

See composer install script in composer.json.

All versions of puppy with dependencies

PHP Build Version
Package Version
Requires php Version >=5.4
raphhh/puppy-application Version ~1.0
raphhh/puppy-config Version ~1.0
raphhh/puppy-static-route Version ~1.0
raphhh/puppy-template Version ~1.0
raphhh/puppy-session Version ~1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package raphhh/puppy contains the following files

Loading the files please wait ....