Silexが2018年6月にEOLになることが発表されました。
SilexのEOLは非常に残念ですが、Symfony4+Flexにより、Symfonyが小さなアプリから大規模なシステムまでカバーできるようになったため、Silexはその役割を終えた、ということなのだろうなと考えています。
今回は、Silex-SkeletonをSymfony4+Flexの構成に移行してみたので、その手順を紹介したいと思います。
前提
- Silex-SkeletonをSymfony4+Flexの構成に移行します
- PHP7.1.3以上の環境が必要です
環境のセットアップ
まずはSilex-Skeltonをcloneし、動かすまで。
$ git clone https://github.com/silexphp/Silex-Skeleton.git
$ cd Silex-Skeleton
$ composer install
$ composer run
> echo 'Started web server on http://localhost:8888'
Started web server on http://localhost:8888
> php -S localhost:8888 -t web
http://localhost:8888 にアクセスし、Welcome to your new Silex Application!が表示されればOKです。単純な表示確認なので、確認できればCTRL+Cでサーバを止めてもらって構いません。
ディレクトリ構成
Symfony4+Flexのディレクトリ構成は以下のディレクトリ構成にする必要があります。
symfony+flex/
├── assets/
├── bin/
│ └── console
├── config/
│ ├── bundles.php
│ ├── packages/
│ ├── routes.yaml
│ └── services.yaml
├── public/
│ └── index.php
├── src/
│ ├── ...
│ └── Kernel.php
├── templates/
├── tests/
├── translations/
├── var/
└── vendor/
Silex-Skeltonのディレクトリ構成を見てみると、以下のようになっています。
silex-skelton/
├── bin/
│ └── console
├── config/
│ ├── dev.php
│ └── prd.php
├── web/
│ └── index.php
├── src/
│ ├── app.php
│ ├── console.php
│ └── controllers.php
├── templates/
├── tests/
├── var/
└── web/
└── index.php
webがpublicに変わっている以外は、それほど違いはありません。いったんはこのままで進めます。
composer.jsonのマージ
Upgrading Existing Applications to Flexにある通り、ディレクトリ構成はほぼ同じなので、あとは依存関係をあわせていく必要があります。
Silex-Skeletonのcomposer.jonとSymfony+Flexのcomposer.jsonをマージします。
Symfony+Flexのcomposer.jsonはcomposer create-project symfony/skeleton xxxとかで作っておくとわかりやすいです。
composer.jsonをがっちゃんこしたのが、以下になります。
// composer.json
- "php": ">=5.5.9",
+ "php": "^7.1.3",
+ "ext-iconv": "*",
+ "symfony/console": "^4.0",
+ "symfony/flex": "^1.0",
+ "symfony/framework-bundle": "^4.0",
+ "symfony/lts": "^4@dev",
+ "symfony/yaml": "^4.0",
"silex/silex": "~2.0",
"silex/web-profiler": "~2.0",
"symfony/asset": "~2.8|^3.0",
"symfony/browser-kit": "~2.8|^3.0",
"symfony/class-loader": "~2.8|^3.0",
"symfony/config": "~2.8|^3.0",
- "symfony/console": "~2.8|^3.0",
"symfony/css-selector": "~2.8|^3.0",
"symfony/debug": "~2.8|^3.0",
"symfony/finder": "~2.8|^3.0",
@@ -23,8 +28,18 @@
"symfony/twig-bridge": "~2.8|^3.0",
"symfony/validator": "~2.8|^3.0"
},
+ "require-dev": {
+ "symfony/dotenv": "^4.0"
+ },
"autoload": {
- "psr-0": { "": "src/" }
+ "psr-4": {
+ "App\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "App\\Tests\\": "tests/"
+ }
},
ここから、composer update --devすると、いくつかのファイルやディレクトリが生成されます。
// composer update後のgit status
$ git status
On branch master
Your branch is up-to-date with 'origin/master'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: .gitignore
modified: composer.json
Untracked files:
(use "git add <file>..." to include in what will be committed)
.env.dist
composer.lock
config/bundles.php
config/packages/
config/routes.yaml
config/routes/
config/services.yaml
flex/
public/
src/Controller/
src/Kernel.php
symfony.lock
translations/
Symfony+Flexで必要なディレクトリやファイルが生成されているのがわかります。
この状態で、php -S localhost:8000 -t publicし、http://localhost:8000/ にアクセスしてみましょう。※ドキュメントルートは、webではなくpublicを指定します。
多分こんなエラーが表示されると思います。
FileLoaderLoadException
The autoloader expected class "App\app" to be defined in file "/Users/xxx/repos/Silex-Skeleton/vendor/composer/../../src/app.php". The file was found but the class was not in it, the class name or namespace probably has a typo in /Users/xxx/repos/Silex-Skeleton/config/services.yaml (which is loaded in resource "/Users/xxx/repos/Silex-Skeleton/config/services.yaml").
これは、Symfonyがsrc以下のファイルをすべてコンテナに登録しようとしており、その際にapp.phpでエラーになっています。
config/services.yamlを編集して除外しておきます。
// config/services.yaml
App\:
resource: '../src/*'
- exclude:'../src/{Entity,Migrations,Tests}'
+ exclude:'../src/{Entity,Migrations,Tests,app.php,console.php,controllers.php}'
app.phpの移行
ここから、Silexのアプリケーションを移行していきます。
Silexのエンドポイントであるweb/index.phpをみると、
// web/index.php
$app = require __DIR__.'/../src/app.php';
require __DIR__.'/../config/prod.php';
require __DIR__.'/../src/controllers.php';
$app->run();
のようになっています。
src/app.phpでは、いくつかのサービスプロバイダが有効になっています。
// src/app.php
$app->register(new ServiceControllerServiceProvider());
$app->register(new AssetServiceProvider());
$app->register(new TwigServiceProvider());
$app->register(new HttpFragmentServiceProvider());
サービスプロバイダはSymfonyでは利用できないため、バンドル等に移行していく必要がありますが、ここで必要なのはTwigServiceProviderのみです。それ以外は、FrameworkBundleに含まれているため、特に何もする必要はありません。
TwigServiceProviderに対応するTwigBundleをインストールします。
$ composer req twigでインストールします。
config/prd.phpをみると、
// config/prd.php
$app['twig.path'] = array(__DIR__.'/../templates');
$app['twig.options'] = array('cache' => __DIR__.'/../var/cache/twig');
のように定義されていますが、composer req twigで、config/twig.yamlが生成されており、twigのパスなどはすでに設定されている状態になっています。
twig:
paths: ['%kernel.project_dir%/templates']
debug: '%kernel.debug%'
strict_variables: '%kernel.debug%'
ここで、http://localhost:8000/ にアクセすると、やはりエラーになりますが、NotFoundHttpExceptionにエラー内容が変わっていると思います。※あとついでにエラー画面もSilexのものよりリッチになっています。
コントローラの移行
Silexのコントローラは、src/controllers.phpに定義されています。
// src/controlelrs.php
$app->get('/', function () use ($app) {
return $app['twig']->render('index.html.twig', array());
})
->bind('homepage')
;
Symfonyの場合、コントローラはsrc/Controller/以下にコントローラのクラスを配置します。
コントローラはコマンドで生成するのが楽なので、以下のようにMakerBundleをインストールします。
$ composer req annotations make
※MakerBundleがSensioExtraFrameworkBundleに依存するため、annotationsで合わせてインストールしています。
$ bin/console make:controllerでコントローラを作成します。
$ bin/console make:controller
Choose a name for your controller class (e.g. DeliciousGnomeController):
> IndexController
created: src/Controller/IndexController.php
作成されたIndexControllerをSilexのコントローラに合わせ、以下のように編集します。
// src/Contoroller/IndexController.php
class IndexController extends Controller
{
/**
- * @Route("/index", name="index")
+ * @Route("/", name="homepage")
*/
public function index()
{
// replace this line with your own code!
- return $this->render('@Maker/demoPage.html.twig', [ 'path' => str_replace($this->getParameter('kernel.project_dir').'/', '', __FILE__) ]);
+ return $this->render('index.html.twig');
}
}
http:localhost:8000 にアクセスし、Welcome to your new Silex Application!が表示されれば成功です。
もし更新されない場合は、キャッシュされている場合もあるので$ bin/console cache:clearでキャッシュをクリアしてみてください。
以上で、Silex-SkeletonをSymfony4+Flexの構成で動かすまでができました。
ただ、Silex-Skeletonはほんとに最小構成なので、実際に運用されているシステムの場合は、他にも色々移行する必要があるかと思います。
無理にSilexのまま移植していくよりかは、SymfonyのSkeletonの上に載せ替えていくほうが楽かな、と思いました。
次項で各種サービスプロバイダの移行先バンドル・ライブラリを調べてみたので、参考にしてみてください。
各種サービスプロバイダの移行
Silex-Skeletonは必要最小限の構成のため、各種サービスプロバイダを利用している場合は、それぞれSymfonyの各バンドルやライブラリへ移行する必要があります。
Silexの公式で紹介されているサービスプロバイダの移行先バンドルは以下になります。
AssetServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
composer req asset でasset componentをインストールすれば利用できます。
CsrfServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
composer req symfony/security-csrfでsecurity-csrfをインストールすれば利用できます。
DoctrineServiceProvider
Doctrine Bundleをインストールします。
composer req doctrineでインストールできます。
FormServiceProvider
Form Componentをインストールします。
composer req formでインストールできます。
HttpCacheServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
HttpFragmentServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
LocaleServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
MonologServiceProvider
Monolog Bundleをインストールします。
composer req monologでインストールできます。
RememberMeServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
SecurityServiceProvider
SecurityBundleをインストールします。
composer req securityでインストールできます。
SerializerServiceProvider
serializer componentをインストールします。
composer req symfony/serializerでインストールできます。
ServiceControllerServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
SessionServiceProvider
FrameworkBundleに含まれているため、バンドルのインストールは不要です。
SwiftmailerServiceProvider
SwiftmailerBundleをインストールします。
composer req mailでインストールできます。
TranslationServiceProvider
translation componentをインストールします。
composer req symfony/translationでインストールできます。
TwigServiceProvider
TwigBundleをインストールします。
composer req twigでインストールできます。
ValidatorServiceProvider
validator comoponentをインストールします。
composer req symfony/validatorでインストールできます。
VarDumperServiceProvider
DebugBundleをインストールします。
composer req debug-packでインストールできます。
以上です。
Symfonyを触り始めてまだ2〜3週間程度なので、移行先のバンドルやライブラリについては誤りがあるかもしれません。もし間違いなどありましたらご指摘いただけるとありがたいです。