CssToInlineStyles
A PHP class that converts HTML with external CSS into HTML with inline styles, primarily for email compatibility.
What is CssToInlineStyles?
CssToInlineStyles is a PHP class that converts HTML pages with external CSS into HTML with inline styles. It solves the problem of inconsistent email rendering by ensuring styles are applied directly to HTML elements, which is necessary because many email clients do not support external stylesheets.
PHP developers building email-sending functionality in web applications, especially those using frameworks like Laravel or content management systems like Fork CMS.
Developers choose CssToInlineStyles for its simplicity, reliability, and specific focus on email HTML compatibility, with easy integration via Composer and proven adoption in major projects.
Overview
CssToInlineStyles is a class that enables you to convert HTML-pages/files into HTML-pages/files with inline styles. This is very usefull when you're sending emails.
Use Cases
Best For
- Ensuring email HTML renders consistently across different email clients
- Converting newsletter templates with external CSS to inline styles
- Integrating email styling into PHP-based web applications
- Processing HTML content for email campaigns in Laravel projects
- Handling CSS inlining for transactional emails
- Improving email deliverability and appearance by using inline styles
Not Ideal For
- Projects requiring CSS pseudo-selectors like :hover or :before for interactive styling
- Applications with non-UTF-8 content or where automatic charset detection is critical
- General web development where maintainable, external CSS is preferred over inline styles for scalability
Pros & Cons
Pros
Built specifically for email HTML, ensuring inline styles for consistent rendering across clients that strip external CSS, as highlighted in its philosophy.
Features an easy-to-use PHP class with a straightforward convert() method and Composer installation, making it quick to implement, as shown in the example code.
Widely adopted by major projects like Laravel and Fork CMS, indicating trust and real-world testing in production environments.
Solves a single problem well—converting CSS to inline styles—without unnecessary bloat, ideal for email-centric workflows.
Cons
Lacks support for pseudo selectors and CSS escapes, as admitted in the README's known issues, breaking complex styling in emails.
UTF-8 detection is unreliable and requires specific meta tags, which can fail with improperly formatted HTML, adding manual overhead.
Primarily designed for email styling, so it's inefficient for general web development where inline styles hinder maintainability and performance.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.