[pkg-php-pear] Bug#821562: php-apigen-theme-bootstrap: PHP 7.0 Transition

[Ondřej Surý]

Package: php-apigen-theme-bootstrap
Version: 1.1.3+dfsg-1
Severity: important
User: pkg-php-maint at lists.alioth.debian.org
Usertags: php7.0-transition

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Dear maintainer(s),

this bug is a part of ongoing php7.0 transition.  It is filled as
important, but the severity will be bumped to serious within quite short
(~month) timeframe as the transition was announced almost 3 months ago.

The php-apigen-theme-bootstrap package currently depends on php5
php5-common .

PHP 7.0 has landed in unstable with substantial changes to the packaging:

  1. Every package built from src:phpMAJOR.MINOR now include
     phpMAJOR.MINOR in the name, so f.e. php5-fpm is now php7.0-fpm.

  2. Accompanying src:php-defaults builds 1:1 mapping to a default
     MAJOR.MINOR version, e.g. php-fpm depends on php7.0-fpm.  When you
     specify a dependency, please use the generic name, unless you
     absolutely know that won't work for you.

  3. Every path in the system has been changed to a versioned, e.g.
     /etc/php5/cli is now /etc/php/7.0/cli

  4. dh_php5 is now dh_php

  5. php-pear is not built from independent source package.

  6. master-7.0 branches of several extensions (php-apcu, xdebug,
     php-apcu-bc) can be used as a template how to change the PHP
     extension packaging.  It's mostly cut&paste since the d/rules tries
     to figure-out most of the variables from debian/ directory.

  7. pkg-php-tools package now supports PHP 7.0 packaging and if your
     package uses pkg-php-tools a simple binNMU is all it might need

  8. PHP 7.0 has changed extension API, so most-if-not-all extensions
     need work from upstream to be compatible with PHP 7.0.

  9. We expect to ship next Debian release (stretch) only with PHP
     7.0, that means that all packages needs to be made compatible with
     PHP 7.0.  Fortunately the PHP 7.0 is mostly compatible with properly
     maintained software.  However some extensions has been deprecated
     (f.e. mysql) and thus old unmaintained software will stop working
     and it will have to be either patched or removed from stable Debian.

So what you need to do:

Replace every occurence of php5 with just php, e.g. if you depend on
'php5' then you just need to depend on 'php'.  Also if you package a web
application and depend on specific SAPI, I would recommend depending just
on 'php' package and let the user decide whether he will install php-fpm,
libapache2-mod-php or php-cgi.

The script that was used to get the list of packages for MBF was not a
particular smart one (so it doesn't detect alternatives, etc.), so if
there's a false positive, please excuse me and just close the bug with
short explanation.

The other options that might be used with packages that don't and won't
support PHP 7.0 is to remove the software from Debian by changing the
title of this bugreport to:

    RM: php-apigen-theme-bootstrap -- ROM; doesn't support PHP 7.0

reassigning it to ftp.debian.org pseudo-package and changing severity to
'normal'.

Also feel free to contact the maintainers at one of the lists:

pkg-php-pear at lists.alioth.debian.org -- for PEAR related packages
pkg-php-pecl at lists.alioth.debian.org -- for PHP extensions
pkg-php-maint at lists.alioth.debian.org -- main PHP packaging and catch-all

Cheers, Ondrej

- -- System Information:
Debian Release: 8.4
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.2.0-35-generic (SMP w/24 CPU cores)
Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQJ8BAEBCgBmBQJXFUqZXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w
ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQzMEI5MzNEODBGQ0UzRDk4MUEyRDM4RkIw
Qzk5QjcwRUY0RkNCQjA3AAoJEAyZtw70/LsHkq8QAM9VjmXGcmGSbLQckav0NFeC
tLfzwOelBljVbRxOwgokky65AZEGaT4iZHB6XKTPKI2v3pEdkPcIEsUSxQuz2J4k
GeDySg6cPso0fL+A1MANnL/M3ql71ASwaAL49roYVMedRpZnr/4EFhlqp5wXfbbM
0guyr1F1GBB/9CDKbXQsiR5UpCfN9nJaSZ8xO3ER83W6BGrTw9ErYFuJkpLHGEy3
It6PnOyN5BzOMmYQV4MqVa4/y9h2LvQ89/LmlHchrud8b8ObFFpjzQkKpMt6iTYl
n2w+MzVSxcdb8naSB9ID/Pq791xAjGiCu6+tHe/vBVLSk12r62eSz93d65/kJLBf
2VsG2w+WF2EbHDraOkZyDXSwS8M1UdRcftduTia17DrxFSrbFJsvTm/ICoi4AAne
gdCfsETV4On62+XM4LwwvlSP8T+L/bWGR0n61TieIZp/ekupybM/LWRK0wOtHRa1
V/FI4vvNVQ/Jtttpbj8X24wYXcwWjDiBygYkr+bk96Dk/4c2VU8NFfUVePqUCKC5
S/OKx7W40m17M0SW7Q1sGRM/OVZGW2uTV+QT4WXSsG0BuBVaHiBXycYvPLXNNGGZ
FMdW2Ho4ocHRaWuoW8NHOpEQ+b/ixHiqjHNurcFyJbxRJeNQ2uefnguRcPZbQV2F
/uCSyrzF/djxAbWBrZiW
=NQSy
-----END PGP SIGNATURE-----