     1: <?php
     2: /**
     3:  * Licensed to the Apache Software Foundation (ASF) under one or more
     4:  * contributor license agreements. See the NOTICE file distributed with
     5:  * this work for additional information regarding copyright ownership.
     6:  * The ASF licenses this file to You under the Apache License, Version 2.0
     7:  * (the "License"); you may not use this file except in compliance with
     8:  * the License. You may obtain a copy of the License at
     9:  *
    10:  *     http://www.apache.org/licenses/LICENSE-2.0
    11:  *
    12:  * Unless required by applicable law or agreed to in writing, software
    13:  * distributed under the License is distributed on an "AS IS" BASIS,
    14:  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    15:  * See the License for the specific language governing permissions and
    16:  * limitations under the License.
    17:  *
    18:  * @package log4php
    19:  */
    20:
    21: /**
    22:  * This filter drops all logging events.
    23:  *
    24:  * You can add this filter to the end of a filter chain to
    25:  * switch from the default "accept all unless instructed otherwise"
    26:  * filtering behaviour to a "deny all unless instructed otherwise"
    27:  * behaviour.
    28:  *
    29:  * <p>
    30:  * An example for this filter:
    31:  *
    32:  * {@example ../../examples/php/filter_denyall.php 19}
    33:  *
    34:  * <p>
    35:  * The corresponding XML file:
    36:  *
    37:  * {@example ../../examples/resources/filter_denyall.xml 18}
    38:  *
    39:  * @version $Revision: 883108 $
    40:  * @package log4php
    41:  * @subpackage filters
    42:  * @since 0.3
    43:  */
    44: class LoggerFilterDenyAll extends LoggerFilter {
    45:
    46:     /**
    47:      * Always returns the integer constant {@link LoggerFilter::DENY}
    48:      * regardless of the {@link LoggerLoggingEvent} parameter.
    49:      *
    50:      * @param LoggerLoggingEvent $event The {@link LoggerLoggingEvent} to filter.
    51:      * @return LoggerFilter::DENY Always returns {@link LoggerFilter::DENY}
    52:      */
    53:     public function decide(LoggerLoggingEvent $event) {
    54:         return LoggerFilter::DENY;
    55:     }
    56: }
    57: