Drupal 7 Bundle by Ekino
, (*1)
Requires at least Drush 5.0 for compatibility with Symfony console., (*2)
The bundle tries to deeply integrate Symfony2 with Drupal and Drupal with Symfony2. Of course this is done without
altering the Drupal's core., (*3)
When this bundle is activated, the Symfony2 console will have the Drupal libraries autoloaded. So, it makes possible
the use of Drupal libraries from your Symfony2 command., (*4)
Install
Download the symfony2 sandbox and the Drupal code
Install the files to have the following structure
Symfony Sandbox Root
- app
- vendor
- src
- web (Drupal source code)
The web directory must be the document root and contains the Drupal source code., (*5)
Update the index.php file
This file "share" the container with Drupal so it is possible to reuse Symfony2's services from within Drupal. The
initialization process is always handled by Symfony2., (*6)
``` php
<?php
require_once DIR.'/../app/bootstrap.php.cache';
require_once DIR.'/../app/AppKernel.php';
//require_once DIR.'/../app/bootstrap_cache.php.cache';
//require_once DIR.'/../app/AppCache.php';, (*7)
use Symfony\Component\HttpFoundation\Request;, (*8)
$kernel = new AppKernel('dev', true); //
$kernel->loadClassCache();
$kernel->boot();, (*9)
// make the Symfony container available from Drupal file
global $container;, (*10)
$container = $kernel->getContainer();, (*11)
$request = Request::createFromGlobals();, (*12)
$response = $kernel->handle($request);
$response->send();, (*13)
$kernel->terminate($request, $response);, (*14)
### Install the related Drupal module
The module can be downloaded from the following url: https://github.com/ekino/ekino_drupal_symfony2
### Configuration
Edit the Symfony ``config.yml`` file and add the following lines:
parameters:
session.flashbag.class: Ekino\Bundle\DrupalBundle\Port\DrupalFlashBag
session.attribute_bag.class: Ekino\Bundle\DrupalBundle\Port\DrupalAttributeBag
framework:
# ... configuration options
session:
# ... configuration options
storage_id: ekino.drupal.session.storage
ekino_drupal:
root: %kernel.root_dir%/../web
logger: ekino.drupal.logger.watchdog
strategy_id: ekino.drupal.delivery_strategy.symfony
# attach a security token to the following provider keys
provider_keys: [main, admin]
# not required
entity_repositories:
# 3 equivalent examples of configuration:
- { bundle: page }
- { type: node, bundle: page }
- { type: node, bundle: page, class: Ekino\Bundle\DrupalBundle\Entity\EntityRepository }
# you can also define an entity repository:
- { type: node, class: Application\Ekino\Bundle\DrupalBundle\Entity\Node\NodeRepository }
# switch to true if you want to prefix the name of Symfony tables
table_prefix:
enabled: false
prefix: symfony__
exclude: [users]
# optional
session:
refresh_cookie_lifetime: true # default value: false
# declare 2 required mapping definition used by Drupal
doctrine:
dbal:
driver: %database_driver%
dbname: %database_name%
user: %database_user%
host: %database_host%
port: %database_port%
password: %database_password%
charset: UTF8
mapping_types:
longblob: object
blob: object
# Tips: this allows Doctrine to consider only tables starting with
# "symfony__" during a migration generation.
# Think to add Doctrine migrations table here or configure it in
# the doctrine_migrations section (table_name)
schema_filter: ~^(symfony__|migration_versions)~
The bundle comes with 3 delivery strategies:
* ekino.drupal.delivery_strategy.background: Drupal never returns the response, Symfony does
* ekino.drupal.delivery_strategy.drupal: Drupal always returns the response, even if the page is 404
* ekino.drupal.delivery_strategy.symfony: Drupal returns the response only if the page is not 404
The (optional) section ``entity_repositories`` allows you to easy interact with
Drupal API to retrieve contents and handle it from Symfony code.
The configuration offers default values:
* default entity type is ``node``
* default repository class is ``Ekino\Bundle\DrupalBundle\Entity\EntityRepository``, feel free to configure yours
Update Queries
--------------
``` sql
UPDATE users SET `emailCanonical` = `mail`, `usernameCanonical` = `name`, `roles` = 'b:0;';
Usage
Symfony components can be used from within Drupal:, (*15)
``` php
<?php
function drupal_foo_function() {
$result = symfony_service('reusage_service')->foo();, (*16)
// do some stuff with $result
}, (*17)
Security
--------
You can secure a Symfony route with a Drupal permission, with prefix PERMISSION_DRUPAL_.
Like it:
``` yml
security:
role_hierarchy:
# ...
firewalls:
# ...
access_control:
- { path: ^/symfony/admin, role: PERMISSION_DRUPAL_ACCESS_ADMINISTRATION_PAGES }
The PERMISSION_DRUPAL_ACCESS_ADMINISTRATION_PAGES is translate in "access administration pages"
and used with user_access and global Drupal user., (*18)
If you want use you "personal access" permission, use role PERMISSION_DRUPAL_PERSONAL_ACCESS for example., (*19)
Limitations
- It is not possible to use Symfony native class to manage session as Drupal initializes its own session handler
and there is no way to change this.
- requests must be served through the index.php as it is the default value in the .htaccess file and there is no
way to change the default script in Drupal
Preview
If installation is completed successfully, the welcome page looks like:, (*20)
, (*21)
You can note the Web Debug Toolbar of Symfony at the bottom ;-)., (*22)
Wallogit.com
