DH_PHPCOMPOSER(1)

💖 DH_PHPCOMPOSER(1) — the debhelper one, bestie 💖

okay so this is the manual page for dh_phpcomposer, part of the debhelper fam. pull up a chair, grab a boba, we're doing this 🧋✨

---

✨ NAME ✨

dh_phpcomposer — she calculates PHP Composer substvars 💅 no cap, that's literally her whole job

---

🌸 SYNOPSIS 🌸

dh_phpcomposer [debhelper options] [options]

---

🦋 DESCRIPTION 🦋

so dh_phpcomposer is a debhelper program, and her entire main character moment is generating the ${phpcomposer:*} substitutions and dropping them into substvars files 🎀

she goes looking for a composer.json file in the package root, and then uses that info to cook up:

• ${phpcomposer:name} and ${phpcomposer:description}
• ${phpcomposer:Debian-require}, ${phpcomposer:Debian-require-dev}, ${phpcomposer:Debian-conflict}, ${phpcomposer:Debian-replace}, ${phpcomposer:Debian-provide}, ${phpcomposer:Debian-suggest} and ${phpcomposer:Debian-recommend}

those variables get substituted into the package's control file wherever you've placed the ${phpcomposer:*} token 👑

⚠️ heads up bestie: this feature needs pkg-php-tools (>= 1.7~). like, it will not work without it, periodt.

---

💅 OPTIONS 💅

• --sourcedirectory=directory — tell her that the original package source tree lives in the directory you specify, instead of assuming it's sitting at the top level directory of the Debian source package tree 🗂️

⚠️ and this one specifically needs pkg-php-tools (>= 1.14~), so don't come crying to me if you're on an older version 😭

---

🎀 FILES 🎀

• debian/pkg-php-tools-overrides — if a package is being a lil rebel and does not want to follow the automatic Composer-package-name-to-Debian-package-name conversion, you can override that conversion by creating this file 🫶

more info lives in dh_phppear(1), go read it, iykyk 📖

---

👑 CONFORMING TO 👑

Debian policy, version 3.9.6. ✅

PHP PEAR policy, version yet-to-be-written. 💀 yeah. it's giving "coming soon" but make it 4-ever.

---

🌈 SEE ALSO 🌈

debhelper(7), pkg-php-tools(7), /usr/share/doc/pkg-php-tools/README.Composer ✨

---

💜 AUTHOR 💜

Mathieu Parent <sathieu@debian.org> — thank you for your service, icon 🫡

---

and that's the whole page, bestie!! this one's 1.49build1, dated 2025-12-06 — go forth and let dh_phpcomposer handle your substvars, she's got you 🧚💖🔥