Giter VIP home page Giter VIP logo

geta-setta's Introduction

geta-setta

Build status Coverage Status License PHP Version Packagist Version

This library 'geta-setta' provides getter method and setter method.

Using the magic method __call when be invoked inaccessible method, if the prefix of the method name is set, an argument value is set to the property. And if the prefix of the method name is get, a value of the property is returned.

When those prefix is nothing, if there is the argument, an argument value is set to the property with the same name as the method name. And if there is not the argument, a value of the property with the same name as the method name is returned.

geta-setta requires PHP >= 5.4.0.

Installation

$ composer require pinekta/geta-setta

Usage

<?php

namespace Foo\bar;

use Pinekta\GetaSetta\AccessorAvailable;

class AudioPlayer
{
    use AccessorAvailable;
    private $disc;
    private $tune;
}

$audioPlayer = new AudioPlayer();
$audioPlayer->setDisc('Editors [The Back Room]')
            ->setTune('Bullets');
echo $audioPlayer->getDisc();            // "Editors [The Back Room]" outputs
echo $audioPlayer->getTune();            // "Bullets" outputs

$audioPlayer->disc('Can [Monster Movie]');
            ->tune('You Doo Right');
echo $audioPlayer->disc();               // "Can [Monster Movie]" outputs
echo $audioPlayer->tune();               // "You Doo Right" outputs

Advanced Usage

Set values collectively

class AudioPlayer
{
    use AccessorAvailable;
    private $disc;
    private $tune;
}

$audioPlayer = new AudioPlayer();
// Case array
$audioPlayer->fill([
    'disc' => 'Number Girl [SAPPUKEI]',
    'tune' => 'ZEGEN VS UNDERCOVER',
]);

// Case object
$set = new \stdClass();
$set->disc = 'Joy Division [Unknown Pleasures]';
$set->tune = 'New Dawn Fades';
$audioPlayer->fill($set);

Unwritable properties

If you want to exclude writing certain properties (like 'id'), you add $gsUnwritableProps property in the calling class.

class Disc
{
    use AccessorAvailable;
    protected static $gsUnwritableProps = ['id'];
    private $id;
    private $name;
    private $size;
}

$disc = new Disc();
$disc->setId(100);                // BadMethodCallException occurs

Please use it if there are properties that is troublesome when written.

Inaccessible properties

If you want to exclude certain properties, you add $gsInaccessibleProps property in the calling class.

class AudioPlayer
{
    use AccessorAvailable;
    protected static $gsInaccessibleProps = ['tune'];
    private $disc;
    private $tune;
}

$audioPlayer = new AudioPlayer();
$audioPlayer->setDisc('Captain Beefheart [Trout Mask Replica]');
echo $audioPlayer->getDisc();            // "Captain Beefheart [Trout Mask Replica]" outputs

$audioPlayer->setTune('Ella Guru');      // BadMethodCallException occurs
$audioPlayer->getTune();                 // BadMethodCallException occurs
$audioPlayer->tune('Well');              // BadMethodCallException occurs
$audioPlayer->tune();                    // BadMethodCallException occurs

Please use it if there are properties that is troublesome when accessed. In addition, if both gsUnwritableProps and gsInaccessibleProps is exists in the code, gsInaccessibleProps takes precedence.

Contributing

Contributions are welcome! This project adheres to a Contributor Code of Conduct. By participating in this project and its community, you are expected to uphold this code. Please read CONTRIBUTING for details.

Copyright

The pinekta/geta-setta is copyright © @pinekta.

License

The pinekta/getta-setta is licensed under the MIT License. Please see LICENSE for more information.

geta-setta's People

Contributors

pinekta avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.