debpear(1)

📦 version 0.5, in debian bookworm, ubuntu jammy, ubuntu noble

💖 debpear — bestie's guide to the manual page 💖

okay so picture this: you're in the General Commands Manual, you flip to debpear(1), and suddenly your whole PEAR-to-Debian pipeline is ✨handled✨. that's the vibe. let's get into it 🫶

🌸 NAME 🌸

debpear — the lil icon that automatically builds and installs PEAR packages as Debian packages. no cap, it does the whole thing for you. 👑

✨ SYNOPSIS ✨

debpear [options] <pear-package-name>

🦋 DESCRIPTION 🦋

so debpear is literally a tool that automatically creates and builds a Debian package out of a PHP PEAR package. here's the glow-up sequence, step by step:

  • it downloads the PEAR package from pear.php.net 🍓
  • then, by looking into it, it creates the corresponding Debian package 🎀
  • and eventually it also installs it for you 💅

it's giving "I got you, bestie" energy fr fr.

🧚 PARAMETERS 🧚

  • <pear-package-name> — this is the PEAR package name you wanna install, exactly as you'd see it on the http://pear.php.net/ site. make sure you respect the case in the name of the package (for example: Package_NAME). yes, case matters, don't play with it 😭

💅 OPTIONS 💅

  • --build-dir|-b — tells debpear where the Debian package is gonna be built. pick your spot, queen 🏗️
  • --verbose|-v — makes debpear more verbose. more words, more info, more ✨content✨.
  • --channel|-c channel-alias — specify the channel-alias, which comes from the pear-channels package — pear and pecl channel. 🌈
  • --tarball|-t tarball --pkg-version|-pv pkg-version [--wget|-w URL] — do not use "pear download" to obtain the PEAR package from upstream authors. instead, use tarball and use pkg-version when building the package. and eventually also download the tarball from URL using wget before building. lowkey the DIY route 🧰
  • --install|-i — install the resulting debian package on your system. > ⚠️ note that you must be root to use this option. if you aren't root, then debpear will try to get root using sudo. so like, it'll try, but you've been warned 💀

🎀 EXAMPLE 🎀

okay bestie, examples time, this is the fun part:

debpear -i Auth_RADIUS

this will create a php-auth-radius package in ./build-area, and automatically install it. and why does it do that? because it's written in the package.xml shipped with Auth_RADIUS at pear.php.net, php-auth-radius will depend on php5-radius. iykyk 🔥

debpear -t current.tgz -pv 1.3.1 -w
http://downloads.jasig.org/cas-clients/php/current.tgz CAS

this one downloads cas-clients from http://downloads.jasig.org/cas-clients/php/current.tgz, as current.tgz in the current directory, then builds it as if it was downloaded as CAS-1.3.1.tgz by "pear download". iconic behaviour honestly ⭐

debpear -c pecl gnupg

this will create a php-gnupg package from the pecl.php.net channel. 🌸

debpear -c phpunit DbUnit

this will create a php-dbunit package from the pear.phpunit.de channel. 💜

👑 IMPORTANT 👑

okay now the serious part, bestie, don't skip this one 🙈

note that the debian/copyright file generated by debpear isn't good enough for redistribution of the created packages. you should carefully review the PEAR package license before doing so. 🚨

also, debpear has been created for convenience, but it will never replace the manual work of an experienced Debian maintainer for creating PEAR packages. it can, however, be used to create a template package quickly, before a careful review, in order to save time building a Debian PEAR package. so like — a starting point, not a final answer. main character tool, but you're still the main character 💅

🌈 AUTHORS 🌈

debpear has been written by Thomas Goirand <zigo@debian.org>, and is maintained inside the PKG PHP PEAR Debian team, that can be reached at: <pkg-php-pear@lists.alioth.debian.org>. 💖

and that's the whole page, bestie!! this was debpear(1) from the General Commands Manual, and yes, the page footer is literally just debpear(1) again — the manual really said "signature look, no date, no version, just vibes" 😭✨ 🦋💖

📦 where this page comes from