Symfony: custom error pages

404

Create your own ‘default’ module in the app’s modules/ directory, override the error404 action and add an error404Success.php template.

500

Create an error500.php template in the main web directory inside a dir called errors/.

Unavailable

Displayed during a symfony cc. Create an unavailable.php template in the main web directory inside a dir called errors/. More info

Symfony: forwarding to 404 when a record is not found

$this->forward404Unless($this->vacancy instanceof Vacancy);

Symfony security: useful methods for the view

Check if user is logged in:

$sf_user->isAuthenticated()

Check if user belongs to a specific group:

$sf_user->hasCredential('admin')

Symfony: creating a custom generator theme as a plugin

Assuming you’re using Doctrine rather than Propel…

Create the plugin

Create a folder, for example:

plugins/sfMyAdminThemePlugin

Copy the default theme

Copy the contents of

plugins/sfDoctrinePlugin/data/generator/sfDoctrineAdmin/default

to your new plugin folder - both the skeleton and template directories.

Generate the admin tools

./symfony doctrine-init-admin appname modulename basedOnThisClassDefinition

Example:

./symfony doctrine-init-admin admin sfGuardUser sfGuardUser

Change the theme inside the module’s generator.yml

For example, here’s my apps/admin/modules/sfGuardUser/config/generator.yml:

generator:
  class:              sfDoctrineAdminGenerator
  param:
    model_class:      sfGuardUser
    theme:            mindGymAdmin

Generate the admin tools again

Repeat the step above.

Symfony: get current environment

sfConfig::get('sf_environment')

Symfony: forwarding a request to another action

$this->forward('default', 'module');

Symfony: internal URIs and link_to

link_to expects an internal URI:

module/action?arg1=val1&arg2=val2

Passing it a routed URL like /foo/bar/baz will not work. You can find the current internal URI using:

sfRouting::getInstance()->getCurrentInternalUri();

Symfony: accessing the request

The commonly used

$this->getRequestParameter('blah')

is a shortened version of

$this->getRequest()->getRequestParameter('blah')

All sorts of other goodies are available using $this->getRequest(), including for example:

$this->getRequest()->getPathInfo()

Symfony: current module name

$moduleName = sfContext::getInstance()->getModuleName();

Custom stylesheets in Symfony

Stylesheets are specified in config/view.yml files. These files can exist globally in config/, at the application level in apps/appname/config, or for individual modules (including plugin modules) under modules/modulename/config. Properties are inherited from the level above, so if you define this in apps/appname/config/view.yml:

default:
  stylesheets: [reset, main]

…all pages will have reset.css and main.css included (in that order). To override this for an individual module (an admin page, perhaps), you can use this magic:

all:
  stylesheets: [-*, admin]

The -* part instructs the view to ignore any stylesheets specified further up the chain. You can also specify the order that stylesheets are included using the ‘position’ attribute. For example:

all:
  stylesheets: [-*, admin: { position: last }]