Documentation

Table of Contents

  1. Migration : How to upgrade from Temma 1.x to version 2
  2. Installation : Download Temma and install it to start your web project
  3. Configuration : All the configuration directives of the etc/temma.json file and the optional environment variables
  4. External libraries : How to use external function libraries
  5. Routing : Temma's default routing system, and advanced routing
  6. Log : Use of the log system, management by criticality levels
    1. Log managers : How to create your own log managers
    2. Syslog : To send your logs to a Syslog server
    3. Datadog : To send your logs to the Datadog service
  7. Controllers : Essential parts of your web application
  8. Views : Smarty templates or JSON/CSV/RSS/iCal/INI exports
    1. Smarty : Default view, based on Smarty templates
    2. JSON : JSON export, with or without data validation
    3. CSV : CSV export
    4. RSS : RSS stream export
    5. INI : INI-format export
    6. iCal : iCal calendar export
  9. Dependency injection : The backbone of your application developments
  10. Sessions : Extension of user sessions managed by PHP
  11. Data sources : Unified data access management
    1. SQL : Access to relational databases
    2. Memcache : Access to Memcached servers
    3. Redis : Access to Redis servers
    4. File : Access to local file storage
    5. S3 : Access to Amazon S3 storage
    6. SQS : Access to Amazon SQS message queues
    7. Beanstalk : Access to Beanstalkd message queue servers
  12. Model : How to use DAOs to access databases
    1. Generic DAO : Simple DAO objects, to easily access a table
    2. Custom DAO : Custom objects, to encapsulate complex queries
  13. Execution flow : How to manage the execution flow, between plugins and the controller
  14. Plugins : How to use plugins, and create your own plugins to modularize your code
  15. Attributes : How to filter access to controllers and actions
  16. Command-line interface : To create executable scripts on the command line, automatically initialized by Temma
  17. Helpers : Items offered by Temma to help you in various circumstances
    • Command-line scripts
      1. Cache : To clear the cache.
      2. User : To manage users.
    • Controller + plugin
      1. Auth : Controller and plugin to manage user authentication
    • Plugins
      1. Api : To manage API access
      2. Cache : To cache the generated HTML pages
      3. Language : Multilingual localization management
    • Attributes
      1. Auth : To restrict access to authenticated users
      2. Method : To manage the authorized HTTP methods
      3. Referer : To filter access by HTTP REFERER
      4. Redirect : To redirect requests automatically
    • Utility objects
      1. ANSI : To format texts written to standard output
      2. BaseConvert : To do digital base conversions
      3. DataFilter : To filter and validate data
      4. Email : To send emails
      5. HTMLCleaner : To clean up an HTML stream coming from a WYSIWYG editor
      6. IniExport : To export data in INI format
      7. Json : To read JSON streams that may contain comments
      8. Lock : To lock access to a file, or the execution of the current PHP script
      9. Registry : To properly store global variables
      10. Smarty : To process Smarty templates outside the view
      11. Term : Terminal management (TTY)
      12. Text : Different treatments on character strings
      13. Timer : To manage stopwatches

Components

Migration

The main differences between Temma 1.x and version 2

Installation

Temma installation is very easy, by cloning the Git repository

Configuration

Temma configuration is based on a JSON file and optional environment variables

External libraries

Integrate easily external libraries to your projects

Routing

Temma's routing system is intentionally very simple by default, but can be extended

Log

Writing to the log files is done in a simple and expressive way, making debugging easier

Controllers

Temma's controllers are simple to build and operate, and can be easily extended

Views

Smarty templates by default, but also JSON, CSV, RSS, iCal, INI exports

Dependency injection

This component is the backbone of your application developments

Sessions

Record data relating to a user session, to switch to stateful operation.

Data sources

Unified access to different data sources (SQL, Redis, Memcache, files, S3, SQS, Beanstalkd…)

Model

Access to databases is done using the DAO pattern, with or without cache

Execution flow

Temma uses an easy-to-use plugin system to manage query execution

Plugins

Modify the behavior of your application using pre- or post-controller plugins

Attributes

Protect or modify access to controllers and actions using PHP attributes

Command-line interface

Easily run command-line scripts, initialized by Temma

Helpers

Temma provides severals objects to facilitate some processings.