本文实例讲述了Laravel 5.1 on SAE环境开发方法。分享给大家供大家参考,具体如下:
Laravel-简洁、优雅的PHP开发框架,为 WEB 艺术家创造的 PHP 框架,如今正式移植到SAE环境。
由于Laravel 5.1相比于Laravel 4有很多的改动,不仅以目录结构更加清晰,而且功能也更丰富。但是Laravel官方还是没有原生支持SAE环境(估计永远不会支持),所以我就做了一个移植版本,可以很优雅的切换本地和SAE环境。
由于SAE的特殊性,那么这几个核心问题就必须要解决
#1 putenv()函数禁用
#2 模板编译
#3 缓存类
#4 日志处理
#5 Session类
#6 服务提供者缓存
#1 putenv()函数禁用
Laravel 5.1使用了这个putenv()函数来向当前的环境中动态添加变量,但是很遗憾的是SAE的PHPRuntime禁用了该函数,所以只能使用折中的方法来实现。当初本来想Hook掉该实现,后来觉得没必要,这个函数在Laravel 5.1中主要是为了使用.env配置文件来统一团队的配置。所以我是直接禁用了该功能,在vendor/vlucas/phpdotenv/src/Dotenv.php的86行左右,直接注释掉该函数,然后把所有的配置信息都写到config文件夹的相应配置文件中。虽然解决了该函数被禁用的问题,但是实现的不够优雅,希望有大神可以给出更加优雅的实现。
#2 模板编译
该问题主要还是因为SAE的本地环境写入被禁止,所以我使用了Wrapper来把编译后的模板文件写入到Storage。本来是打算写到KVDB中,但是会出现一些奇奇怪怪问题,原因不明。
在config\view.php文件中修改:
1
2
3
4
5
6
7
8
9
10
|
$compiled = [ 'paths' => [ realpath (base_path( 'resources/views' )), ], 'compiled' => realpath (storage_path( 'framework/views' )), ]; if (SAE){ $compiled [ 'compiled' ] = 'saestor://' .SAE_STORAGE. '/compiled' ; } return $compiled ; |
注意要在相应的Storage中建立compiled文件夹。
#3 缓存类
Laravel 5.1没有直接提供SAE可用的Memcache缓存驱动,这个解决比较简单,直接写一个服务提供者注册到app.php即可,然后在config\cache.php中注册,具体实现看项目源码
#4 日志处理
这也是一个比较棘手的问题,由于Laravel 5.1的日志处理已经不是和4一样使用服务提供者,而且直接注入到启动器中,这就使得我们只能覆写原生ConfigureLogging启动类,而官方也没有给出如何覆写和在哪里覆写,所以我这边的解决方案是判断当前环境为SAE后直接重写Http内核中的一个启动器属性,核心代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
namespace Illuminate\Cloud\SAE; use App\Http\Kernel as DefaultKernel; class Kernel extends DefaultKernel{ /** * The bootstrap classes for the application. * * @var array */ protected $bootstrappers = [ 'Illuminate\Foundation\Bootstrap\DetectEnvironment' , 'Illuminate\Foundation\Bootstrap\LoadConfiguration' , 'Illuminate\Cloud\SAE\Log\ConfigureLogging' , 'Illuminate\Foundation\Bootstrap\HandleExceptions' , 'Illuminate\Foundation\Bootstrap\RegisterFacades' , 'Illuminate\Foundation\Bootstrap\RegisterProviders' , 'Illuminate\Foundation\Bootstrap\BootProviders' , ]; } |
这样还不行,还必须重写日志的部分实现
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
class Writer extends IlluminateLogWriter { protected function useSaeLog( $level = 'debug' ){ $level = $this ->parseLevel( $level ); $this ->monolog->pushHandler( $handler = new SaeLogHandler( $level )); $handler ->setFormatter( $this ->getDefaultFormatter()); } public function useFiles( $path , $level = 'debug' ){ if (SAE) { return $this ->useSaeLog( $level ); } parent::useFiles( $path , $level ); } public function useDailyFiles( $path , $days = 0, $level = 'debug' ){ if (SAE) { return $this ->useSaeLog( $level ); } parent::useDailyFiles( $path , $days , $level ); } } |
#5 Session类
Laravel5.1的session依旧是本地写的问题,参考了Laravel4的移植,使用了memcache作为session的实现,具体可以结合缓存部分来处理
#6 服务提供者缓存
在应用程序的启动过程中,laravel会在bootstrap/cache/services.json生成服务提供者的缓存,为了加快下次访问的速度,依旧是本地写的问题,解决方案很简单,使用Storage的Wrapper即可
以上这些问题解决后,差不多就算成功了。最后修改下bootstrap\app.php来实现本地与SAE环境的优雅切换,主要是判断环境然后生成SAE专有应用实例和注入相应的Http内核。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
/* |-------------------------------------------------------------------------- | Create The Application |-------------------------------------------------------------------------- | | The first thing we will do is create a new Laravel application instance | which serves as the "glue" for all the components of Laravel, and is | the IoC container for the system binding all of the various parts. | */ define( 'SAE' ,true); define( 'SAE_STORAGE' , 'laravel' ); if (SAE){ $app = new Illuminate\Cloud\SAE\Application( realpath (__DIR__. '/../' ) ); $app ->singleton( Illuminate\Contracts\Http\Kernel:: class , Illuminate\Cloud\SAE\Kernel:: class ); } else { $app = new Illuminate\Foundation\Application( realpath (__DIR__. '/../' ) ); $app ->singleton( Illuminate\Contracts\Http\Kernel:: class , App\Http\Kernel:: class ); } /* |-------------------------------------------------------------------------- | Bind Important Interfaces |-------------------------------------------------------------------------- | | Next, we need to bind some important interfaces into the container so | we will be able to resolve them when needed. The kernels serve the | incoming requests to this application from both the web and CLI. | */ $app ->singleton( Illuminate\Contracts\Console\Kernel:: class , App\Console\Kernel:: class ); $app ->singleton( Illuminate\Contracts\Debug\ExceptionHandler:: class , App\Exceptions\Handler:: class ); /* |-------------------------------------------------------------------------- | Return The Application |-------------------------------------------------------------------------- | | This script returns the application instance. The instance is given to | the calling script so we can separate the building of the instances | from the actual running of the application and sending responses. | */ return $app ; |
这里解释下为什么要在bootstrap\app.php中来定义是否为SAE环境,原因很明确了,就是要注入相应的应用程序实例和Http实例,然后再这里也定义一下Storage
然后就是config\app.php的相关配置,根据环境判断来注入相应的服务提供者
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
if (SAE){ $removeProviders = [ Illuminate\Cache\CacheServiceProvider:: class , Illuminate\Session\SessionServiceProvider:: class , ]; for ( $i = 0; $i < count ( $app [ 'providers' ]); $i ++){ if (in_array( $app [ 'providers' ][ $i ], $removeProviders )) { unset( $app [ 'providers' ][ $i ]); } } $app [ 'providers' ] = array_merge ( $app [ 'providers' ],[ Illuminate\Cloud\SAE\Cache\SaeCacheServiceProvider:: class , Illuminate\Cloud\SAE\Session\SessionServiceProvider:: class , Illuminate\Cloud\SAE\Storage\StorageServiceProvider:: class , Illuminate\Cloud\SAE\Segment\SegmentServiceProvider:: class , ]); $app [ 'aliases' ][ 'Storage' ] = Illuminate\Cloud\SAE\Storage\Storage:: class ; $app [ 'aliases' ][ 'Segment' ] = Illuminate\Cloud\SAE\Segment\Segment:: class ; } |
最后再说说SAE专有应用程序实例和Http实例与原生的差别,主要还是本地写的问题。原生的会在应用程序启动时候生成路由、配置、服务提供者、模板编译的相关文件,以此来提升加载速度。但是到了SAE就不行了,所以重写了Application类的部分与路径相关的方法,来把这些文件生成到Storage中,而Http专有内核则是处理启动器中的日志类。具体代码就不贴出来,可以看看项目。
再给一个SAE可以使用的rewrite
1
2
3
|
handle: - rewrite: if (path ~ "^/$" ) goto "public/index.php" - rewrite: if (!is_dir() && !is_file() && path~ "^(.*)$" ) goto "public/index.php/$1" |
总结
整个移植过程还算是很顺利,得益于Laravel的拓展性与SAE的便利.不过在对于putenv()函数和日志处理的解决方法上,还是实现的不够优雅,希望能有人给出更有优雅的实现方案。然后其他的SAE服务比如分词、邮件、队列等,则可以使用服务提供者自动加载,这个就不多说了。
项目github地址: https://github.com/wh469012917/laravel5-on-sae
希望本文所述对大家基于Laravel框架的PHP程序设计有所帮助。