phpBB3.2开发环境配置
从Github导出项目
如果只是查看代码, 可以直接clone官方的git https://github.com/phpbb/phpbb.git . 如果需要开发, 就fork一下再从自己的Git里clone.
下载依赖
PhpStorm IDE方式
在PS中打开composer.json, 右上角会提示有install, 点击后, 选择系统中的PHP可执行文件, 选择下载composer.phar, 然后确定即可.
在墙内会比较慢, 可以在composer.json里加上这一段, 使用phpcomposer.com提供的镜像服务
"repositories": {
"packagist": {
"type": "composer",
"url": "https://packagist.phpcomposer.com"
}
}
命令行方式:
在 phpBB 目录下执行
php ../composer.phar install
执行结果, 能看到项目依赖的各个库的版本, 其中symfony版本是3.4.15
~/PhpstormProjects/phpbb/phpBB$ php ../composer.phar install Loading composer repositories with package information Installing dependencies (including require-dev) from lock file Package operations: 76 installs, 0 updates, 0 removals - Installing composer/installers (v1.5.0): Downloading (100%) - Installing bantu/ini-get-wrapper (v1.0.1): Downloading (100%) - Installing symfony/process (v3.4.15): Downloading (100%) - Installing symfony/finder (v3.4.15): Downloading (100%) - Installing symfony/polyfill-ctype (v1.9.0): Downloading (100%) - Installing symfony/filesystem (v3.4.15): Downloading (100%) - Installing symfony/polyfill-mbstring (v1.9.0): Downloading (100%) - Installing psr/log (1.0.2): Downloading (100%) - Installing symfony/debug (v3.4.15): Downloading (100%) - Installing symfony/console (v3.4.15): Downloading (100%) - Installing seld/phar-utils (1.0.1): Downloading (100%) - Installing seld/jsonlint (1.7.1): Downloading (100%) - Installing justinrainbow/json-schema (5.2.7): Downloading (100%) - Installing composer/xdebug-handler (1.3.0): Downloading (100%) - Installing composer/spdx-licenses (1.4.0): Downloading (100%) - Installing composer/semver (1.4.2): Downloading (100%) - Installing composer/ca-bundle (1.1.2): Downloading (100%) - Installing composer/composer (1.7.2): Downloading (100%) - Installing google/recaptcha (1.2.1): Downloading (100%) - Installing guzzlehttp/promises (v1.3.1): Downloading (100%) - Installing psr/http-message (1.0.1): Downloading (100%) - Installing guzzlehttp/psr7 (1.4.2): Downloading (100%) - Installing lusitanian/oauth (v0.8.11): Downloading (100%) - Installing marc1706/fast-image-size (v1.1.4): Downloading (100%) - Installing patchwork/utf8 (v1.3.1): Downloading (100%) - Installing psr/container (1.0.0): Downloading (100%) - Installing s9e/text-formatter (0.13.1): Downloading (100%) - Installing symfony/config (v3.4.15): Downloading (100%) - Installing paragonie/random_compat (v1.4.3): Downloading (100%) - Installing symfony/polyfill-php70 (v1.9.0): Downloading (100%) - Installing symfony/http-foundation (v3.4.15): Downloading (100%) - Installing symfony/event-dispatcher (v3.4.15): Downloading (100%) - Installing symfony/http-kernel (v3.4.15): Downloading (100%) - Installing symfony/dependency-injection (v3.4.15): Downloading (100%) - Installing zendframework/zend-eventmanager (3.2.1): Downloading (100%) - Installing zendframework/zend-code (2.6.3): Downloading (100%) - Installing ocramius/proxy-manager (1.0.2): Downloading (100%) - Installing symfony/proxy-manager-bridge (v3.4.15): Downloading (100%) - Installing symfony/routing (v3.4.15): Downloading (100%) - Installing twig/twig (v1.35.4): Downloading (100%) - Installing symfony/twig-bridge (v3.4.15): Downloading (100%) - Installing symfony/dom-crawler (v3.4.15): Downloading (100%) - Installing symfony/css-selector (v3.4.15): Downloading (100%) - Installing symfony/browser-kit (v3.4.15): Downloading (100%) - Installing guzzlehttp/guzzle (6.3.3): Downloading (100%) - Installing fabpot/goutte (v3.2.3): Downloading (100%) - Installing facebook/webdriver (1.6.0): Downloading (100%) - Installing symfony/yaml (v3.4.15): Downloading (100%) - Installing laravel/homestead (v7.17.0): Downloading (100%) - Installing phing/phing (2.4.14): Downloading (100%) - Installing webmozart/assert (1.3.0): Downloading (100%) - Installing phpdocumentor/reflection-common (1.0.1): Downloading (100%) - Installing phpdocumentor/type-resolver (0.4.0): Downloading (100%) - Installing phpdocumentor/reflection-docblock (3.3.2): Downloading (100%) - Installing sebastian/version (2.0.1): Downloading (100%) - Installing sebastian/resource-operations (1.0.0): Downloading (100%) - Installing sebastian/recursion-context (2.0.0): Downloading (100%) - Installing sebastian/object-enumerator (2.0.1): Downloading (100%) - Installing sebastian/global-state (1.1.1): Downloading (100%) - Installing sebastian/exporter (2.0.0): Downloading (100%) - Installing sebastian/environment (2.0.0): Downloading (100%) - Installing sebastian/diff (1.4.3): Downloading (100%) - Installing sebastian/comparator (1.2.4): Downloading (100%) - Installing phpunit/php-text-template (1.2.1): Downloading (100%) - Installing doctrine/instantiator (1.0.5): Downloading (100%) - Installing phpunit/phpunit-mock-objects (3.4.4): Downloading (100%) - Installing phpunit/php-timer (1.0.9): Downloading (100%) - Installing phpunit/php-file-iterator (1.4.5): Downloading (100%) - Installing sebastian/code-unit-reverse-lookup (1.0.1): Downloading (100%) - Installing phpunit/php-token-stream (1.4.12): Downloading (100%) - Installing phpunit/php-code-coverage (4.0.8): Downloading (100%) - Installing phpspec/prophecy (1.8.0): Downloading (100%) - Installing myclabs/deep-copy (1.7.0): Downloading (100%) - Installing phpunit/phpunit (5.7.27): Downloading (100%) - Installing phpunit/dbunit (2.0.3): Downloading (100%) - Installing squizlabs/php_codesniffer (2.9.1): Downloading (100%) symfony/console suggests installing symfony/lock lusitanian/oauth suggests installing predis/predis (Allows using the Redis storage backend.) patchwork/utf8 suggests installing ext-intl (Use Intl for best performance) patchwork/utf8 suggests installing ext-wfio (Use WFIO for UTF-8 filesystem access on Windows) s9e/text-formatter suggests installing ext-intl (Allows international URLs to be accepted by the URL filter) paragonie/random_compat suggests installing ext-libsodium (Provides a modern crypto API that can be used to generate random bytes.) symfony/http-kernel suggests installing symfony/var-dumper symfony/dependency-injection suggests installing symfony/expression-language (For using expressions in service container configuration) zendframework/zend-eventmanager suggests installing container-interop/container-interop (^1.1.0, to use the lazy listeners feature) zendframework/zend-eventmanager suggests installing zendframework/zend-stdlib (^2.7.3 || ^3.0, to use the FilterChain feature) zendframework/zend-code suggests installing doctrine/annotations (Doctrine\Common\Annotations >=1.0 for annotation features) zendframework/zend-code suggests installing zendframework/zend-stdlib (Zend\Stdlib component) ocramius/proxy-manager suggests installing ocramius/generated-hydrator (To have very fast object to array to object conversion for ghost objects) ocramius/proxy-manager suggests installing zendframework/zend-json (To have the JsonRpc adapter (Remote Object feature)) ocramius/proxy-manager suggests installing zendframework/zend-soap (To have the Soap adapter (Remote Object feature)) ocramius/proxy-manager suggests installing zendframework/zend-stdlib (To use the hydrator proxy) ocramius/proxy-manager suggests installing zendframework/zend-xmlrpc (To have the XmlRpc adapter (Remote Object feature)) symfony/routing suggests installing doctrine/annotations (For using the annotation loader) symfony/routing suggests installing symfony/expression-language (For using expression matching) symfony/twig-bridge suggests installing symfony/asset (For using the AssetExtension) symfony/twig-bridge suggests installing symfony/expression-language (For using the ExpressionExtension) symfony/twig-bridge suggests installing symfony/form (For using the FormExtension) symfony/twig-bridge suggests installing symfony/security (For using the SecurityExtension) symfony/twig-bridge suggests installing symfony/stopwatch (For using the StopwatchExtension) symfony/twig-bridge suggests installing symfony/templating (For using the TwigEngine) symfony/twig-bridge suggests installing symfony/translation (For using the TranslationExtension) symfony/twig-bridge suggests installing symfony/var-dumper (For using the DumpExtension) symfony/twig-bridge suggests installing symfony/web-link (For using the WebLinkExtension) facebook/webdriver suggests installing ext-SimpleXML (For Firefox profile creation) sebastian/global-state suggests installing ext-uopz (*) phpunit/php-code-coverage suggests installing ext-xdebug (^2.5.1) phpunit/phpunit suggests installing ext-xdebug (*) phpunit/phpunit suggests installing phpunit/php-invoker (~1.1) Generating autoload files
在PhpStorm中同时打开多个项目
点击Open后选中项目目录, 在弹出的对话框中, 选择Open in current window, 勾选 Add to currently opened projects.
Nginx配置文件
在phpBB3.2中已经默认使用Restful URL, 例如升级时, 使用的地址是 forum/install/app.php/update, FAQ页面的地址就是 forum/app.php/help/faq , 在论坛安装完成之后, 虽然还可以沿用传统的URL传参形式, 但是要追求完美的话还是要把rewrite加上. 在编写nginx配置时还有另一个考虑就是安全问题. 现在引入那么多第三方库, 可以说出现漏洞的风险是非常大的, 要尽可能地避免这些第三方库带来的安全问题, 首先最简单最容易做到的就是禁止外界直接访问这些脚本.
以下是我使用的Nginx配置文件, 可以根据自己的实际情况修改.
server {
listen 80;
server_name www.rockbb.com;
access_log logs/rockbb.access.log main;
location / {
root /var/wwwroot/rockbb;
index index.html index.htm index.php;
}
# Correctly pass scripts for installer
location /forum/app.php {
root /var/wwwroot/rockbb;
index index.html index.php;
location ~ \.php(/|$) {
include fastcgi_params;
fastcgi_split_path_info ^(.+\.php)(/.*)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME /var/wwwroot/rockbb$fastcgi_script_name;
fastcgi_pass 127.0.0.1:9000;
}
}
# 禁止访问内部phpbb文件
location ~ /forum/(bin|cache|config|ext|files|images/avatars/upload|includes|language|phpbb|
store|vendor|config\.php|common\.php).* {
deny all;
internal;
}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
location ~ \.php$ {
root /var/wwwroot/rockbb;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /$document_root$fastcgi_script_name;
include fastcgi_params;
}
}
几个location匹配的优先级说明
规则是:
先精确匹配, 匹配上哪个就立即用哪个; 然后普通匹配, 不管是否匹配上, 继续进行正则匹配, 如果正则匹配不上, 则回退至上一个普通匹配. 其中普通匹配没有顺序之分, 哪个匹配最精确就使用哪个location, 而正则匹配按照规则的书写顺序进行, 只要匹配上哪个就用哪个:
- = 精确匹配, 匹配后停止后续匹配, 直接执行该匹配后的configuration
- [空格] 前缀匹配. 匹配后继续更长前缀匹配和正则匹配
- ^~ 非正则匹配, 终态前缀匹配(注意与空格的前缀匹配进行区别), 匹配该前缀后，停止后续正则匹配
- ~ 区分大小写的正则匹配, 按顺序匹配，一旦匹配上即停止后续匹配
- ~* 不区分大小写的匹配, 一旦匹配即停止后续匹配
所以nginx配置文件的书写顺序建议是: 先写 = 号(精确匹配)部分, 然后写[空格] 前缀匹配部分, 然后写^~这种前缀匹配, 最后写正则匹配.
