@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Update install and upgrade documentation for libphutil
Summary:
Ref T13395. Libphutil has merged into Arcanist and no longer needs to be installed or upgraded. Additionally:
- The minimum PHP version is now PHP 5.5.
- Although older versions of PHP should still install APC, modern versions come with Opcache and do not need APC. Setup issues guide administrators thorugh the correct install procedure now.
Test Plan: Read documentation.
Maniphest Tasks: T13395
Differential Revision: https://secure.phabricator.com/D21550
+10
-59
-7
scripts/install/install_rhel-derivs.sh
-7
scripts/install/install_rhel-derivs.sh
···
117
117
118
118
confirm
119
119
120
-
if [[ ! -e libphutil ]]
121
-
then
122
-
git clone https://github.com/phacility/libphutil.git
123
-
else
124
-
(cd libphutil && git pull --rebase)
125
-
fi
126
-
127
120
if [[ ! -e arcanist ]]
128
121
then
129
122
git clone https://github.com/phacility/arcanist.git
-6
scripts/install/install_ubuntu.sh
-6
scripts/install/install_ubuntu.sh
+7
-38
src/docs/user/installation_guide.diviner
+7
-38
src/docs/user/installation_guide.diviner
···
64
64
works fine.
65
65
- **Other**: Other webservers which can run PHP are also likely to work fine,
66
66
although these installation instructions will not cover how to set them up.
67
-
- **PHP Builtin Server**: You can use the builtin PHP webserver for
68
-
development or testing, although it should not be used in production.
67
+
- **PHP Builtin Server**: Phabricator will not work with the builtin
68
+
webserver because Phabricator depends on making requests to itself on some
69
+
workflows, and the builtin webserver is single-threaded.
69
70
70
71
You will also need:
71
72
72
73
- **MySQL**: You need MySQL. We strongly recommend MySQL 5.5 or newer.
73
-
- **PHP**: You need PHP 5.2 or newer.
74
+
- **PHP**: You need PHP 5.5 or newer.
74
75
75
76
You'll probably also need a **domain name**. In particular, you should read this
76
77
note:
···
124
125
- PHP (usually "php")
125
126
- Required PHP extensions: mbstring, iconv, mysql (or mysqli), curl, pcntl
126
127
(these might be something like "php-mysql" or "php5-mysqlnd")
127
-
- Optional PHP extensions: gd, apc (special instructions for APC are available
128
-
below if you have difficulty installing it), xhprof (instructions below,
129
-
you only need this if you are developing Phabricator)
128
+
- Optional PHP extensions: gd
130
129
131
130
If you already have LAMP setup, you've probably already got everything you need.
132
131
It may also be helpful to refer to the install scripts above, even if they don't
···
136
135
dependencies:
137
136
138
137
$ cd somewhere/ # pick some install directory
139
-
somewhere/ $ git clone https://github.com/phacility/libphutil.git
140
138
somewhere/ $ git clone https://github.com/phacility/arcanist.git
141
139
somewhere/ $ git clone https://github.com/phacility/phabricator.git
142
140
143
-
= Installing APC (Optional) =
144
-
145
-
Like everything else written in PHP, Phabricator will run much faster with APC
146
-
installed. You likely need to install "pcre-devel" first:
147
-
148
-
sudo yum install pcre-devel
149
-
150
-
Then you have two options. Either install via PECL (try this first):
151
-
152
-
sudo yum install php-pear
153
-
sudo pecl install apc
154
-
155
-
**If that doesn't work**, grab the package from PECL directly and follow the
156
-
build instructions there:
157
-
158
-
http://pecl.php.net/package/APC
159
-
160
-
Installing APC is optional but **strongly recommended**, especially on
161
-
production hosts.
162
-
163
-
Once APC is installed, test that it is available by running:
164
-
165
-
php -i | grep apc
166
-
167
-
If it doesn't show up, add:
168
-
169
-
extension=apc.so
170
-
171
-
..to "/etc/php.d/apc.ini" or the "php.ini" file indicated by "php -i".
172
-
173
-
= Next Steps =
141
+
Next Steps
142
+
==========
174
143
175
144
Continue by:
176
145
+3
-8
src/docs/user/upgrading.diviner
+3
-8
src/docs/user/upgrading.diviner
···
43
43
44
44
phabricator/ $ git checkout stable
45
45
arcanist/ $ git checkout stable
46
-
libphutil/ $ git checkout stable
47
46
48
47
You can now follow the upgrade process normally.
49
48
···
54
53
IMPORTANT: You **MUST** restart Phabricator after upgrading. For help, see
55
54
@{article:Restarting Phabricator}.
56
55
57
-
IMPORTANT: You **MUST** upgrade `libphutil`, `arcanist` and `phabricator` at
58
-
the same time.
56
+
IMPORTANT: You **MUST** upgrade `arcanist` and `phabricator` at the same time.
59
57
60
58
Phabricator runs on many different systems, with many different webservers.
61
59
Given this diversity, we don't currently maintain a comprehensive upgrade
···
64
62
65
63
- Stop the webserver (including `php-fpm`, if you use it).
66
64
- Stop the daemons, with `phabricator/bin/phd stop`.
67
-
- Run `git pull` in `libphutil/`, `arcanist/` and `phabricator/`.
65
+
- Run `git pull` in `arcanist/` and `phabricator/`.
68
66
- Run `phabricator/bin/storage upgrade`.
69
67
- Start the daemons, with `phabricator/bin/phd start`.
70
68
- Restart the webserver (and `php-fpm`, if you stopped it earlier).
···
86
84
# to work without modifications.
87
85
88
86
# NOTE: This script assumes you are running it from a directory which contains
89
-
# arcanist/, libphutil/, and phabricator/.
87
+
# arcanist/, and phabricator/.
90
88
91
89
ROOT=`pwd` # You can hard-code the path here instead.
92
90
···
106
104
sudo /etc/init.d/httpd stop
107
105
108
106
### UPDATE WORKING COPIES ######################################################
109
-
110
-
cd $ROOT/libphutil
111
-
git pull
112
107
113
108
cd $ROOT/arcanist
114
109
git pull