1 { config, lib, pkgs, ... }:
6 cfg = config.services.myPhpfpm;
7 enabled = cfg.poolConfigs != {} || cfg.pools != {};
9 stateDir = "/run/phpfpm";
11 poolConfigs = cfg.poolConfigs // mapAttrs mkPool cfg.pools;
18 fpmCfgFile = pool: poolConfig: pkgs.writeText "phpfpm-${pool}.conf" ''
28 phpIni = poolPhpOptions: (pkgs.runCommand "php.ini" {
29 inherit (cfg) phpPackage phpOptions;
30 inherit poolPhpOptions;
32 sendmail_path = "/run/wrappers/bin/sendmail -t -i"
34 passAsFile = [ "nixDefaults" "phpOptions" "poolPhpOptions" ];
36 cat $phpPackage/etc/php.ini $nixDefaultsPath $phpOptionsPath $poolPhpOptionsPath > $out
43 extraConfig = mkOption {
47 Extra configuration that should be put in the global section of
48 the PHP-FPM configuration file. Do not specify the options
49 <literal>error_log</literal> or
50 <literal>daemonize</literal> here, since they are generated by
55 phpPackage = mkOption {
58 defaultText = "pkgs.php";
60 The PHP package to use for running the PHP-FPM service.
64 phpOptions = mkOption {
72 "Options appended to the PHP configuration file <filename>php.ini</filename>.";
75 serviceDependencies = mkOption {
77 type = types.attrsOf (types.listOf types.string);
78 example = literalExample ''
79 { mypool = ["postgresql.service"]; }
82 Extra service dependencies specific to pool.
86 poolPhpConfigs = mkOption {
88 type = types.attrsOf types.lines;
89 example = literalExample ''
91 extension = some_extension.so
96 Extra lines that go into the php configuration specific to pool.
100 poolConfigs = mkOption {
102 type = types.attrsOf types.lines;
103 example = literalExample ''
105 listen = /run/phpfpm/mypool
109 pm.start_servers = 10
110 pm.min_spare_servers = 5
111 pm.max_spare_servers = 20
112 pm.max_requests = 500
117 A mapping between PHP-FPM pool names and their configurations.
118 See the documentation on <literal>php-fpm.conf</literal> for
119 details on configuration directives. If no pools are defined,
120 the phpfpm service is disabled.
125 type = types.attrsOf (types.submodule (import ./pool-options.nix {
129 example = literalExample ''
132 listen = "/path/to/unix/socket";
137 pm.start_servers = 10
138 pm.min_spare_servers = 5
139 pm.max_spare_servers = 20
140 pm.max_requests = 500
145 PHP-FPM pools. If no pools or poolConfigs are defined, the PHP-FPM
152 config = mkIf enabled {
154 systemd.slices.phpfpm = {
155 description = "PHP FastCGI Process manager pools slice";
158 systemd.targets.phpfpm = {
159 description = "PHP FastCGI Process manager pools target";
160 wantedBy = [ "multi-user.target" ];
163 systemd.services = flip mapAttrs' poolConfigs (pool: poolConfig:
164 nameValuePair "phpfpm-${pool}" {
165 description = "PHP FastCGI Process Manager service for pool ${pool}";
166 after = [ "network.target" ] ++ (cfg.serviceDependencies.${pool} or []);
167 wants = cfg.serviceDependencies.${pool} or [];
168 wantedBy = [ "phpfpm.target" ];
169 partOf = [ "phpfpm.target" ];
174 cfgFile = fpmCfgFile pool poolConfig;
175 poolPhpIni = cfg.poolPhpConfigs.${pool} or "";
177 Slice = "phpfpm.slice";
178 PrivateDevices = true;
179 ProtectSystem = "full";
181 # XXX: We need AF_NETLINK to make the sendmail SUID binary from postfix work
182 RestrictAddressFamilies = "AF_UNIX AF_INET AF_INET6 AF_NETLINK";
184 ExecStart = "${cfg.phpPackage}/bin/php-fpm -y ${cfgFile} -c ${phpIni poolPhpIni}";
185 ExecReload = "${pkgs.coreutils}/bin/kill -USR2 $MAINPID";