PHPackages                             awkwardideas/switchblade - 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. [Templating & Views](/categories/templating)
4. /
5. awkwardideas/switchblade

ActiveLibrary[Templating & Views](/categories/templating)

awkwardideas/switchblade
========================

Extended blade directives for laravel

v1.0.2(9y ago)102.1k2MITPHPPHP >=5.6.4

Since Mar 1Pushed 9y ago1 watchersCompare

[ Source](https://github.com/awkwardideas/SwitchBlade)[ Packagist](https://packagist.org/packages/awkwardideas/switchblade)[ RSS](/packages/awkwardideas-switchblade/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)DependenciesVersions (5)Used By (0)

SwitchBlade: Custom Directives for the Laravel Blade templating engine
======================================================================

[](#switchblade-custom-directives-for-the-laravel-blade-templating-engine)

[![Latest Stable Version](https://camo.githubusercontent.com/9b79b45856af4ccacf2030bba9fab7e35bc9cca91390052cd5c835c42bb2cc97/68747470733a2f2f706f7365722e707567782e6f72672f61776b7761726469646561732f737769746368626c6164652f762f737461626c65)](https://packagist.org/packages/awkwardideas/switchblade)[![Total Downloads](https://camo.githubusercontent.com/faed00f817427ad021ae218851b2fade6750b96d9d1b67861c06bfe8c11762a7/68747470733a2f2f706f7365722e707567782e6f72672f61776b7761726469646561732f737769746368626c6164652f646f776e6c6f616473)](https://packagist.org/packages/awkwardideas/switchblade)[![Latest Unstable Version](https://camo.githubusercontent.com/86d3f23e3859ac0d7e3c317066b9e2cd61e56b4720db59b99f290b2d6b0911a6/68747470733a2f2f706f7365722e707567782e6f72672f61776b7761726469646561732f737769746368626c6164652f762f756e737461626c65)](https://packagist.org/packages/awkwardideas/switchblade)[![License](https://camo.githubusercontent.com/3bf2fdcb6e686854471b6a7675c0ab227e7630d32f055048b9ccabe0d53f535e/68747470733a2f2f706f7365722e707567782e6f72672f61776b7761726469646561732f737769746368626c6164652f6c6963656e7365)](https://packagist.org/packages/awkwardideas/switchblade)

Install Via Composer
--------------------

[](#install-via-composer)

```
$ composer require awkwardideas/switchblade
```

Add to config/app.php
---------------------

[](#add-to-configappphp)

Under Package Service Providers Add

```
AwkwardIdeas\SwitchBlade\SwitchBladeServiceProvider::class,
```

Available Directives
====================

[](#available-directives)

Switch via Blade
----------------

[](#switch-via-blade)

A php switch statement implemented via blade.

The switch statement is similar to a series of IF statements on the same expression. In many occasions, you may want to compare the same variable (or expression) with many different values, and execute a different piece of code depending on which value it equals to. This is exactly what the switch statement is for.

- `@switch(expression, caseStatement1 [, caseStatement2, caseStatement3...])`
    - This is the blade call to start the switch. It requires the expression and the first case statement. Optionally you can add as many case statements as you would like, which would all execute the code between the start of the switch and the first `@endcase` call.
- `@endcase`
    - Add this to end the case statement. Only one is needed to stop all prior cases.
- `@case(caseStatement1 [, caseStatement2, caseStatement3...])`
    - Add this to start a case statement. Optionally you can add as many case statements as you would like, which would all execute the code between the `@case`and next `@endcase` call.
- `@defaultcase`
    - Add this near the bottom of the switch to handle any variants of the expression which may not have been captured by a case statement. No end case is necessary since it will end with `@endswitch`
- `@endswitch`
    - Add this to end your switch statement

---

Variable Modification
---------------------

[](#variable-modification)

Set, increment or decrement variables without having to go in and out of php.

- `@set(variable, value)`
- `@increment(variable)`
- `@decrement(variable)`

---

Variable Output
---------------

[](#variable-output)

- `@htmlAttribute(value)`
    - Echos the value safe for use in html attributes like id
- `@explode(delimiter, string, index)`
    - Echos the index of the exploded result of the string, split by the delimiter
- `@implode(delimiter, array)`
    - Echos the string result of the array joined by the delimiter

---

Debug Tools
-----------

[](#debug-tools)

- `@dd(variable)`
    - Does a dump and die on the variable
- `@varDump(variable)`
    - Does a dump of the variable
- `@getenv(ENV_VAR_NAME)`
    - Echos the environment variable

---

Other helpful directives
------------------------

[](#other-helpful-directives)

- `@continue`
    - Adds a php continue; tag to skip the rest of the current loop iteration
- `@break`
    - Adds a php break; tag which ends the execution of a for, foreach, do-while or switch structure

### If empty

[](#if-empty)

- `@ifempty(variable)`
    - If count of variable == 0
- `@endifempty`
    - Ends if empty statement

### If null

[](#if-null)

- `@ifnull(variable)`
    - If variable is null
- `@endifnull`
    - Ends if null statement

### Not Null

[](#not-null)

- `@notnull(variable)`
    - If variable is not null
- `@endnotnull`
    - Ends not null statement

### Optional Yield

[](#optional-yield)

- `@optional('section')`
    - Outputs the content wrapped only if the referenced section has value
- `@endoptional`
    - Ends optional output statement

### File exists

[](#file-exists)

- `@iffileexists(filepath)`
    - Tests file path, continuing only if file exists
- `@endiffileexists`
    - Ends file exists condition

### Has Count

[](#has-count)

- `@hascount(variable)`
    - Obtains the count of the variable, continuing if it is greater than 0
- `@endhascount`
    - Ends has count condition

\##Lang Modification

- `@lang(key[, replace, locale])`
    - Modified to pass through to choice of 1, allowing plurals to be put in without having to have all singular usages changed to choice.

\##Bag

- `@bag(variable[,value])`
    - Appends a variable to a bag, or echos the bag as a list

### Init Script

[](#init-script)

- `@initScript([scriptName])`
    - Adds the script name to a bag if a parameter is passed. If no parameter is passed, the contents of the bag are dumped into a javascript window property.

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 57.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

4

Last Release

3392d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/17416801?v=4)[Awkward Ideas](/maintainers/awkwardideas)[@awkwardideas](https://github.com/awkwardideas)

---

Top Contributors

[![svenluijten](https://avatars.githubusercontent.com/u/11269635?v=4)](https://github.com/svenluijten "svenluijten (4 commits)")[![dachusa](https://avatars.githubusercontent.com/u/1718958?v=4)](https://github.com/dachusa "dachusa (3 commits)")

### Embed Badge

![Health badge](/badges/awkwardideas-switchblade/health.svg)

```
[![Health](https://phpackages.com/badges/awkwardideas-switchblade/health.svg)](https://phpackages.com/packages/awkwardideas-switchblade)
```

###  Alternatives

[limenius/react-bundle

Client and Server-side react rendering in a Symfony Bundle

3861.2M](/packages/limenius-react-bundle)[area17/laravel-auto-head-tags

Laravel Auto Head Tags helps you build the list of head elements for your app

4616.0k](/packages/area17-laravel-auto-head-tags)[jelix/wikirenderer

WikiRenderer is a library to generate HTML or anything else from wiki content.

1712.2k1](/packages/jelix-wikirenderer)[webkinder/sproutset

A Composer package for handling responsive images in Roots Bedrock + Sage + Blade projects.

291.8k](/packages/webkinder-sproutset)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)