gipetto/cowsay

An extensible PHP port of the Cowsay linux utility

PHP CowSay

, _(*1)

An extensible PHP port of the Linux Cowsay utility., _(*2)

Requirements

• Minimum: PHP 8.1+
• Recommended: PHP 8.2+

CowSay will update to stay in step with the latest, actively supported PHP version. See the Official PHP list of supported versions, _(*3)

Install

$ composer require Gipetto/CowSay

Quickstart

use CowSay\Cow;

$bessie = new Cow('Hello, Farm!');

// store the output in a variable
$output = $bessie->say();
echo $output;

// or just echo the object for direct output
echo $bessie;

Displays:, _(*4)

  ------------
< Hello, Farm! >
  ------------
          \   ^__^
           \  (oo)\_______
              (__)\       )\/\
                  ||----w |
                  ||     ||

Run php demo.php to see all the included cows and their traits., _(*5)

Traits

Cows support a few traits. You can specify the Eyes, Tongue, Udder and, yes, you can specify Poop., _(*6)

$bessie = new Cow('Hello, Farm!');
$bessie->setEyes('oO')
    ->setTongue('U')
    ->setPoop('@@@')
    ->setUdder('W');
echo $bessie;

Displays:, _(*7)

  ------------
< Hello, Farm! >
  ------------
          \   ^__^
           \  (oO)\_______
              (__)\       )\/\
               U  ||----W |
                  ||     || @@@

Extending CowSay

Adding New Carcases

CowSay is easily extended to add new carcases for your custom needs. See the Carcasses tutorial for more information., _(*8)

Adding New Traits

It is easy to add new Traits to CowSay. See the Custom Traits documentation for more information., _(*9)

Known Issues

• Line length calculations are not fully understood for strings with longer byte length characters. ie: Chinese.

License

CowSay is licensed under The MIT License (MIT)., _(*10)