PHPackages lasserafn/php-initial-avatar-generator - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. lasserafn/php-initial-avatar-generator ActiveLibrary[Image & Media](/categories/media) lasserafn/php-initial-avatar-generator ====================================== A package to generate avatars with initials for PHP 4.5(7mo ago)4374.2M—4.3%67[8 issues](https://github.com/LasseRafn/php-initial-avatar-generator/issues)[2 PRs](https://github.com/LasseRafn/php-initial-avatar-generator/pulls)12MITPHPPHP ^7.0|^7.1|^7.2|^7.3|^7.4|^8.0|^8.1|^8.2 Since Jan 14Pushed 7mo ago12 watchersCompare [ Source](https://github.com/LasseRafn/php-initial-avatar-generator)[ Packagist](https://packagist.org/packages/lasserafn/php-initial-avatar-generator)[ Fund](https://opencollective.com/ui-avatars)[ RSS](/packages/lasserafn-php-initial-avatar-generator/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (43)Used By (12) Generate avatars with initials ============================== [](#generate-avatars-with-initials) Ever seen those avatars (basically everywhere) that has your initials — mine would be LR; Lasse Rafn — well this package allows you to generate those, in a simple manner. [![Banner](https://camo.githubusercontent.com/5d6883d2e6af43c48675eb2ddb641ffd4ae1d937b8af72adf1d6a45411a2b916/68747470733a2f2f75692d617661746172732e636f6d2f6173736574732f70726f6d6f2d6e65772e706e67)](https://camo.githubusercontent.com/5d6883d2e6af43c48675eb2ddb641ffd4ae1d937b8af72adf1d6a45411a2b916/68747470733a2f2f75692d617661746172732e636f6d2f6173736574732f70726f6d6f2d6e65772e706e67) [![Build Status](https://github.com/LasseRafn/php-initial-avatar-generator/actions/workflows/test.yml/badge.svg)](https://github.com/LasseRafn/php-initial-avatar-generator/actions/workflows/test.yml)[![OtterWise Coverage](https://camo.githubusercontent.com/77ac642bf95fac64a36211c2739f71cd3696971c57f15a9e7448e7fd1fa3b0d8/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f75726c3d68747470733a2f2f6f74746572776973652e6170702f62616467652f6769746875622f6c617373657261666e2f7068702d696e697469616c2d6176617461722d67656e657261746f722f636f7665726167652f36646236666362622d393561362d343436612d623561312d313564376231383039646361)](https://otterwise.app/github/lasserafn/php-initial-avatar-generator)[![OtterWise Coverage](https://camo.githubusercontent.com/caa57ccc5a460919918e13db8fac706fab2643de8a14339a07ebf86b43e39cb7/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f75726c3d68747470733a2f2f6f74746572776973652e6170702f62616467652f6769746875622f6c617373657261666e2f7068702d696e697469616c2d6176617461722d67656e657261746f722f636f6d706c65786974792f36646236666362622d393561362d343436612d623561312d313564376231383039646361)](https://otterwise.app/github/lasserafn/php-initial-avatar-generator)[![StyleCI Status](https://camo.githubusercontent.com/f62aa8b0c1899ab7ecf63aeb7daac1e22d0a3dd0d142dc3ecf646ad924aa0460/68747470733a2f2f7374796c6563692e696f2f7265706f732f37383937333731302f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/78973710)[![Total Downloads](https://camo.githubusercontent.com/a8b3b7deb2d1502906d1208d46e76ee705020732523263bee1269a5e89909cf3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4c617373655261666e2f7068702d696e697469616c2d6176617461722d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/LasseRafn/php-initial-avatar-generator)[![Latest Stable Version](https://camo.githubusercontent.com/4e34637f3280bf1c97fcbf60e9596a89ccdebc98f2c5633df57806942b80f07f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4c617373655261666e2f7068702d696e697469616c2d6176617461722d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/LasseRafn/php-initial-avatar-generator)[![License](https://camo.githubusercontent.com/ac35bee2d4aae64058a9968d112b94d06071f73b388363bd95d16c63865d4da2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f4c617373655261666e2f7068702d696e697469616c2d6176617461722d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/LasseRafn/php-initial-avatar-generator) [![OtterWise Code Coverage reporting](https://camo.githubusercontent.com/321d523f9167cb3da34119242f42fe834e39b60b884e9c1823fd8834a8c2adeb/68747470733a2f2f6765746f74746572776973652e636f6d2f696d616765732f6578742f7569617661746172732d61642e706e67)](https://getotterwise.com?ref=ui-avatars-gh) Backers ------- [](#backers) Thank you to all our backers! 🙏 \[[Become a backer](https://opencollective.com/ui-avatars#backer)\] [![](https://camo.githubusercontent.com/f6322c5e93c17ca71d5f2b5f8b5d7f9328c7a9eb9cb8ee3cec5c4a5b063843a5/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f6261636b6572732e7376673f77696474683d383930)](https://opencollective.com/ui-avatars#backers) Sponsors -------- [](#sponsors) Support this project by becoming a sponsor. Your logo will show up here with a link to your website. \[[Become a sponsor](https://opencollective.com/ui-avatars#sponsor)\] [![](https://camo.githubusercontent.com/809f02c7d6f89f014bd85d48205cf84e8e79324448b6203543977a2411526bf9/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f302f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/0/website)[![](https://camo.githubusercontent.com/307b7aa156440746529c33a8fb6a4b3e9f457da9fb9376eb197995ecff54409a/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f312f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/1/website)[![](https://camo.githubusercontent.com/a629c48f94035f2ff38cb964776b0cda5983ecdcf1345376fc399890842f4ec7/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f322f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/2/website)[![](https://camo.githubusercontent.com/e9e8019ef0be2d8c87192f5d3f20a95ac3f292fc3bd6e6c83ef8c929070e0854/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f332f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/3/website)[![](https://camo.githubusercontent.com/e7b00feb631fbb6bdd23bbd1c3f27e120946e8d48dd0a75b91bf9242b2eb6343/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f342f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/4/website)[![](https://camo.githubusercontent.com/6a41fd8665714b067576c6b995326bdaff0fbddae9a610061dfbae456f968a7d/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f352f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/5/website)[![](https://camo.githubusercontent.com/bb80825d16ced60972ab45f701e87d33ad5327e852fb83829f9c8424510e8c40/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f362f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/6/website)[![](https://camo.githubusercontent.com/e67d99a400fa8ac6baf5f1937b42aa75bf8564db581b34552b007173cd71e4c1/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f372f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/7/website)[![](https://camo.githubusercontent.com/8b058d707626f839f2712d8c738a11b03206ba51037f2acb28663531ec0dac65/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f382f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/8/website)[![](https://camo.githubusercontent.com/ba7dd1be83586a26a8c08514987c1ee776e0689e60232c3879471802211c4d33/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f75692d617661746172732f73706f6e736f722f392f6176617461722e737667)](https://opencollective.com/ui-avatars/sponsor/9/website) **There's also a api you can use: ** Installation ------------ [](#installation) You just require using composer and you're good to go! ``` composer require lasserafn/php-initial-avatar-generator ``` Rad, *and long*, package name.. huh? Sorry. I'm not very good with names. Usage ----- [](#usage) As with installation, usage is quite simple. Generating a image is done by running: ``` $avatar = new LasseRafn\InitialAvatarGenerator\InitialAvatar(); $image = $avatar->name('Lasse Rafn')->generate(); ``` Thats it! The method will return a instance of [Image from Intervention](https://github.com/Intervention/image) so you can stream, download or even encode the image: ``` return $image->stream('png', 100); ``` You can also just pass along the initials, and it will use those. Should you just include a first name, it will use the first two letters of it. ### Example usage in a webpage [](#example-usage-in-a-webpage) To display the image generated by the InitialAvatarGenerator library directly on a webpage, you can utilize PHP headers to output the image as a stream or generate a temporary file and display it using an `` tag. To output the image as a stream, you can create a separate PHP endpoint (like avatar.php) that generates the avatar image and streams it as a PNG. Then, you use the URL of this endpoint as the src of an `` tag on your webpage. An example endpoint file (**avatar.php**) is below: ```